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Develop web apps faster and 
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Guaranteed to let you knock 
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The NEW BBEdit 4.5! 


It.Doesn't Suck 

'kUl 


There has never been a 
better time to buy 
BBEdit 

Upgrade from BBEdit Lite, 
Codewarrior, MPW, 

Symantec C++ or a niiinber 
of other products for just $79. 

I’his offer Ls available direct 
from Bare Bones Software, Inc. 

To order, call us at (617) 77S-3100 
or visit us online. 



<http://www.barebones.com/> 
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A Bit About Bosion 

fust a weeks ago, as 1 write tills, Steve jobs made a 
numlx^r of sigjtiJiaint announcements at Mac*wt:)rld Hxpo in 
Boston. As is usual with xSteve's commcnLs, they had a euphoric 
aHeci an the audience. In this case, the audience was niudi 
larger than die few diousand people listening live. It included 
Wall Street investors and pn)[>alily the entire community of 
Macintash users. 

The general feeling around the show floor was very positive. 
Steve's announcements may have c^aitsed this feeling. Expo 
attendance was solid, and, more iiiiixmanily, Mac users were 
spending a lot of money at the show. Whether tliey liad extra 
money to spend l>eoause Apple's stock price nearly doubletl or 
liecause they were excited alxjui Mac OS 8 is hard to ,s;iy. 
Nonetheless, attendees showed their support for Madntcxsh by 
buying Maciiniosh pnxluct.s. Many of the venders who chose not 
to attend should lx kicking themselves for missing out on a great 
chance to market and sell their pniducis. 

Rhapsody Andante Pianissimo 

Almost as imix>rtanl as what Steve Jobs said at hxfxj is what 
he didn’t say. He did not talk about Rliapsody, and ihi.s had many 
fxo[)lc asking questions. HLs faikite to mention Rhaf^stxly scvms to 
have lieen a calculaterl move. 'Hiere has been some concern within 
Apple that at the last WWDC Apfile's marketing rruichinc had once 
agjiio hyped a technology Ix^yond what A[iplc engineering could 
fx^ssibly deliver on the st hedule created by executives. As is topical 
of WW1>C, many devciofxrs bought the hype. 

Apple seems to l>e working to reduce i\w liype. and. 
hopc^fuliy, fcKiis fxir atlenturn on what Rhapsody lealiy will deliver. 
Rliapstxly was intended to Ixi the long temi solution. Mac OS H is 
the technology that will be paying the bills for some time to cr>Jtie, 
esfxeially in light of its recent success. Apple also may lx: gelling 
the message from developers that what we see in die developer 
relea.se will tletemiine what resources we put to Rhapsody 
development. No develt^per w'ants to be iray^fX'd again ha.sing a 
[irkIucI on Apple'.s promise of a new technology. DeveltijKrs wilt 
judge tlieir first exjxriemu with Rhapsody camfully, and if 
Rhapsody doesn't live up to Applets pnaiiises, mexst develojXTs will 
not l(X)k at it again until the next major release. Ajiple wants lo get 
it righi die first time. 

I ckni't mean to say RliajxstxJy won't he a gitrat OS. Frankly, 
I won't ix^ able to s;iy one way or die odier until I have a chance 
to work with it. 1 am anxious to work widi it. The idea dial I can 
build apj^licadtins five times faster than I do now, and with 
grc^iiier reliahiJity, appeals to me greatly. I expe-xrt the developer 
leJease to demoastrate how Rhapsody will improve developer 
productivity, even if we don't realize that iniprovement right 
away, (Most of us have a lot to learn Ixfore we on lx? proficient 
building Rhapsody applications.) 

Vij-wroiN'r 


There are other things I expect from llie Rliapstxly developer 
release: 1 expect it to look a bit like the Mac on the surface, but 
not to feel much like one underneath. Apple hadn't planned to 
release the Advanced UI in the develojxrr iuiea.se, anyway, so 
they can have more time with it. (In my opinion, the user 
experience in Mac OS 8 suggests that Apple has foigotten what 
the Mac experience Is all about, hut that is for another column.) 
I expect the Rhapsexly develojXT release to Ik- hIow^, possibly 
slcwer than Mac OS. 1 also expect it to be riddled widi bugs, liut 
hopefully not in die core OS. Apple is relt^sing an early version 
of Rhapstxly to developers so we can Ix-gin to learn how to build 
applications in the dramatically different ]>n)gratTiming 
envin)nment. T expect Apple to give us an OS we can use to 
accomplish that task widiout the iiugs and performance problems 
getting in the way. if they can meet that goal. I will lx foigtving 
of other iimitations of diis preview release. 

Tliere is another mteson Stt*ve Jobs did not mention Rhapsody 
during his keynote addres.s: the imexptxietl .sut trss of Mac OS 8. 
Apple’s new OS has moved off store shelves .so cjuickly, and carried 
along so many odier prcKlutis, that resellers are staning to diink 
Macintosh users inigliL actually have enough money to interest tliem. 
Many "multi-platfornf lesellers have reported Mac OS B sales to rival 
the dollar volume of die release of Windows 95. Gjasetjaently, 
A|>ple would like developers to stay fcKUsed on delivering new and 
better Mac OS ap[ilicaiion,s. .Mac‘ developers know how to do this 
and do it well. I'he numlxr of Mac OS customers will dwarf that of 
RhapMxly for at lea.st the next two years, so maylie we deveIo|xrs 
siiouldn’t lx t(K) hasty to abamion it. 

RliapsfKiy likely will come along a hit more t|uiedy and 
slowly than we were led to Ix^lieve in the first half of tliis yean 
Ap[)Ies claims I lie .server market is one area that will 
immediately tx-nefit from the new technokigy. Others think 
higher education will lx- drawn to die strengtlis of unix Indden 
underneath. There may be merit in all the.se clahm, but the first 
market will be the early adopters. 

Rhapsody should be in dcvekjpers luinds around ihe 
time you read thi.s, or veiy soon after. I exiiect we will soon 
see a wave of many new anci ported .shareware and 
Freeware applications l>uilt just for Rhap.Ht)dy. The.se are our 
first generation KhapstKly products, built us we learn tlie ins 
and tints of this new OS. As developers discover the 
leverage offered hy the ric h toolkits built into Rhapsody, we 
will see more sophisticated applications coming out. Wc' 
already have severa I NCXTSTHP-turned-Rhapsody 
developers showing us wJiat they have been doing all these 
years. If the dream.s iK-ar out, we sfu>yld see some 
revolutionary software enter the market during the coming 
year. IL may ultimately he the plethora of exciting new 
software that drives users to Rfiapsody, not the technical 
superiority of the O^S. Only time will tell. 
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MacHASP Packs 
More Into Less. 

IliLsetlon !vtato-of-tlic-art ASIC technology, 
MaclIASP packs the iiidustr}' s mast 
advanced security' ctimpatibility and 
flexibility into a compact and md-user- 
friendly dongle. 

Grow With Aladdin! 

Tlie fastest growing conipany 
in the industry, widi over 4 
million keys sold to 20 
tliousand ^velo])ers 
worldwide. Aladdin is setting 
the standard forsoflwiue security today. 

NSTL Study Rates 
HASP Mo.1! 

A recent test conducted hy the National 
Softwsire Testing Labs', the world's foremost 
independent lab, compared the flagship PC 
pioducts of leiuiing software protection 
vendors, 'llie result? HASP was rated tlie clear 
overall winner ■ iuid numlterone in at! tite 
major compiirison categories. Kor a full <x>ity 
of tlie NS'll. re])flrt, contact your local 
HASP distributor. 



McmHASP 
PROTECTS 
MORE. 


Mact)S 


Tliese days, more and more developers are choosing to protect their software against 
piracy. 'I'hey’re protecting more prtKlticLs, on more platforms, with better protection - 
and selling more as a result. 



And more of these develoiters are protecting with MacHASP. Wiiy? 
because MacHASP offers more sectirity, more reliability and more 
features than any other product on the market. Only MacHASP offers 
capabilities such xs network support, anti-debugging envelope 
protection, and secure remote activation and updating. 

MacHASP supports the most advanced platlorins, including all 
versions of MacOS and Power Mac - as well as AppleTalk 
networks. And Iwcause Aladdin is a licensed Apple Partner, 

MacHASP guarantees full, transparent compatibility 
with the ADB standard. Atewiw /st emtiaim 


To learn more about how you can protect 
better - and sell more - call now to order 
your MacHASP Developer's Kit. 
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OPENSTEP Localization 


One of the ,sirengths of the Mac OS 
is the way It handles localisation. For 
example, pulling the strings out of yt>ur 
application and storing them as 
resources makes the app relatively 
simple to translate Into anotlier language. 
Of course there's more to localization 
than that, hut the point is, the Mac OS 
supports an underlying mechanism that 
makes localization possible. Foriunaiefy, 
OPFNSTFP (and presumably Rhapsody) 
features a similar mechanism that greatly 
simplifies the localization process. 

A Localization Exampi.f. 

Let’s start ofl‘ with a look at an existing 
application that cakes advantage of the 
OPFNSTEP locaIiz;ttion mechanism. 

* In the Workspace, navigate into the 
directory; 

/Ne^tDeveloper/Examples/AppK 1 1/Text KdiI/E 
ngiish.lproj 

Tliest‘ files are all pan of the TextEdit 
Projectliuilder projeci. Among the files in 
this directory, you1l find a ,series of nib 
files including one named FmdPanel.nih. 
Each nil) file implements a portion of the 
user interface. For example, the file 
Info.nih contains the specs for the 'lexLEdil 
info panel CNeXTSpeak for about 
lx>x).FindPancl.nib contains the specs for 
the Hind panel 

In the same directory, you'lJ also notice 
a pair of files named IjDcalizable.strings and 
rindPanel.stiings. Tlie collection of .strings 
files aa as a repository for all the text strings 
ernlK-dded in the TextEdit source code. 


These files are CTcaled at huikl-iime in response to a set of function 
calls yoiill place in your ccxie. Beftjrc we get to the functions, take 
a closer look at these files. 

• Double-click on the file lxK*alizable.strings. 

The file will open in Edit. As you scroll through the file, 
you'Q notice that it consists of pairs of C comments and 
assignment statements. Herts's an exampit^' 

r Menu item to make the cuncm doriiment rkii text 7 
-{.Make Rich Text" - "iMakc Rich Text"; 

Though this may look like .stjnie sick C axle, this is really 
just a {latabase of strings, where eucli entry consists of a 
comment, followed by a left side and right side pair of strings, 
’llie left side Ls the default siring, which you1l specify in your 
crxie. Ihe right side Is the version of this string used by tliis 
pariiailar language. This example specifies the text to use in tlte 
TextEdit menu item that specifies R'l’H (rich text format). ’Ihe left 
side is the string that appeared in the source txxle, presumably 
done in the native language of the programmer. The right string 
us the Uxiilized string. Since we are in the direaory Engltsh.lproj, 
the right string is in English. 

One Uxralization approach kicks in once youVe done your 
final project build. Once your M7urce is fiozen, you duplicate the 
English.Iproj directory, creating a copy for each foreign language 
you plan on supporting. Fur example, you miglii make a copy of 
Rnglish.lproj named Germandproj. You’d then Ixind this directory 
to your Gennan Iranslalor, Tht^ Gicrman iranslator would step 
through each of the .strings files, translating all ilie right-hand 
strings cn each of the assignment statements to Cemian. 

When you ship your application, you 11 actually ship an 
accompanying direeiory that includes all your XXXJproj 
sulxlLrectories. When the u.ser specifics their preferred language 
using the Preferences application, then runs your application, the 
system uses the Ipnij directory that matches the current 
language. So on an English system, the strings in EnglishJproj 
will be used. On a German system, die Gennan.lproj strings will 
1>e used. Of course, you don’t ham to support multiple 
language.s, but since kx'aliz^tion is so easy to do, you’ll likely 
want to consider supporting more than just your native language. 
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An Existing Lcxiauzed ExaaifU’ 

Let’s take a look at a shipping application that supports 
more than one language. 

• In the Workspace, point your browser to tlie 
/NextDeveloper/Demos directory. 

A series of applkauons will appear in the directory 
(Figure 1). As you'd expect, if you double-click on any of 
these, tlieyUl run. ^fhese .App files arc known as “application 
wrappers”. They hide the underlying directory structure that 
ships with your application and makes them appear as a single 
application file, I'he Workspace dws give you a way to view 
this accompanying directory. 


Take some time to look at some other dircciories 
and applications. Check out some of the other 
applications in /NexiDevdoper/Demos, Check out 
/NextDeveloper/Apps and /NexfApps. Note that some of 
the applications are localized, others are not. Some are 
only partially localized. Some feature a Resources 
directory, Olliers place their XXXJpfoj directories one 
level higher, directly in the app's main direcuiry. This last 
is a clue to the version of ProjeclBuilder used to create 
the application. The ProjeclBuilder that shipped with 
OPENSTEP 4.0 was the first version to emhed the 
XXX.lproj directories in a Resources directory. 

A SlMPli- EXAMPU: 
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• In the File Viewer, click on lexlHdit.App to select it, 

• vSelea Open as Folder from the Workspace's File menu. 


A new File Viewer will appear, showing you the directory 
struclure beneath the TextEdit.app application wrapper (Figure 2). 
At die top level of this direaory is a direatiry named Resources. 
The XXX.lproj dia‘Ctories live inside this directory, Each of the 
XXX.lproj directories contains localized versions of die 
FindPanel strings and Locali7,able.,sirings files. 



Figure Z TextMitApp, opened m a folder instemi of as an 


Let's use ProjectBuilder to build a simple application, then 
localize it. 

• Launch ProjectBuilder, then select New horn tlie Project menu. 

• When the New Project panel appears, select Application from 
the Project Type popup men, type the name Fck> into die 
Name held, dien click OK. 

• In ProjeetBuilder's browser, under Interfaces, double<1ick on 
NKXTSTEP_Fix>.nib (assuming you are running under NexLStep 
— odierwise, double<lick on your appnipriatc nib file). 

You will now find yourself in InterfaceBuikler. As youVe seen 
in past columns, InterfaceBuiicler provides your applicatitm with a 
defiiull window named My Window. Well add a button and a 
static text item to this window, dien localize the text associated 
with diesc‘ two items, just to see localization in atlion. After dial, 
we'll take a look at the functions that bring l<K;alization to life. 

■ In IntcrfaccBuilder, select Palettes from the Tools menu, 
Jhilettes siibmeniL 

• When the Palettes window appears, cUck on die Views icon. 

• Drag a sialic text item (die text in the palene says '"ritle“) into 
"My Window''. 

• Doiible-cUck on the stafit' text item and cliange the text to read: 

This application allows you to control a vehicle on another 
planet 


• Go back to the Palettes window and drag a button into the 
windt>w. 

• Doubleclick on the button and change the text to say OK, 

• Select Save from the DcxaimenL menu. 

• Quit TnterfaceRuilder, 

• Back in ProjeclBuilder, click on rhe hammer icon to bring up 
the Project Build window, 

• Click on the hammer icon in the Project Build window to start 
the build prtxcss. 

You should get a message that says build .succeeded. 

• Quit ProjectBuilder. 
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Now we'll run the app, just to verify that our window 
appears with its static text and button. Once we know' tlie app 
nim, we'll ItKalize it in German, set the system prefs to Gennan, 
then run the app again showing tlie German ItK^ali^ation at work. 

* In the workspace, find the file Fcjo.app (it1l iaside die Foo folder 
yoti created when you first built tlic PfoitxiBiiilder project). 

• Double-click Foo^app. 

Ilie window should apficar containing oitr static text and 
button (Figure 3). 



Figure 3* Fooxfppf fxjhre hxMiizaiUm. 

• Quit Foo.app. 

In die workspace, select Foo.app, then select Open as 
Folder from the File menu. 

• In the Foo.app file viewer open ihtr Resources directory, 
seleca English.lpro), then select Duplicate from the File menu. 

• Rename the duplicate to German. 1 pro). 

• Inside the German.Iproj directory, Double-click 

NFXlVl'EPJoo.nib. 

You'll find yourself in InterfaceBuilder, editing the version of 
the nib file that lives in Gemum.proj. 

• In Intcrl’accBuilder, edit the static text in the main window 
and change it to read: 

Diese aEv^ndting eulflubt thnmi ein fabrzetig $uf ein^ 
anderen planeten 

Big thanks to Andreas Hommef compiler writer 
extraordinaire, for the German translation! ;) 

• Save, then CJuii InterfaceBuildcT. 

Note that w^e didn't change the button text. As it turns out, 
OK in Gennan is OK! Our next step is to run the preferences 
application and change the order of preferred languages so that 
German is first, 

• l>iuble-click on the Preferences application (it's the icon in 
the dock diat looks like a cltx:k). 

• In the Preferences window, click on the left-mtxsi icon (the 
one thill looks like a series of flags). 

• In die scrolling list uf Languages, click on Deutsch and drag 
il to the top of the list (Figure 4). 



Figiiiie 4 We Localization Pnferences, with German (l>eiitsch) 
selected as the preferred language. 

Tlie scrolling list of languages allow you Ct) order the set of 
languages on your madiine. On my mat'hine, I have it set to 
German first (just for this demo), dien Engli.sh, French, Italian, 
and SwedLsh, When 1 run an applicaticm on my machine, the 
order of languages in my preferences determine which iproj 
directory is used to tdeh the application's nib files. In this case, 
the director^^ Gennan.Iproj is used first, then EnglishJproj, 
Frenchiproj, etc. 

• Quit the Freferencx^s application. 

• Go back into die file viewer and run F(Kj.A])p. 

ibis rimL% the text should apf)ear in German (Figure 5). 
Wunderbar! 


fwj My Vrtmtow 



Diese anwendung erlaubt es ihnen ein fahrzeU^j 

auf einem anderen planeten 

.ss 

UJ 

_jr 


Figure 1 Foo.app mnning in German. Cmd! 


The Locauzation Funcuons 

The sample program we just created was re!alively simple. 
All Uxialization wa.s done direedy in the nib file. Earlier in the 
column, we explored the TextEdit appliotion and Siiw that the 
TextEdit text strings w'ere stored in a sea of .strings files. Instead 
of editing the TextEdit nib files, lot'alization was done on these 
.strings files. This is made possible by a set of localization 
functions called by yoLir |)rograiTi any lime it neetls to access a 
localized string, 'I'he functions go out to die appropriate .strings 
file and retrieve the localized vetsion of the specified string. 

'Ihe duee kxalization funciioas were reforring to all start witli 
the name NSLocalizedString. Heie's a ccxil trit:k ytHi am use to search 
for routines in the pawmpiled headers lused by your pnijetis. 

continued on page 12 
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a doubtf the Premiere Resource Editor 
for the Mae OS A wealth of iime-saving tools*^ 

- MacUser Magazine Eddy Awards 

"A distinct improuerjient over Apple's ResEdit.^ 

- Macikch Magazine 

'Every Mae OS developer should own a copy of Resorcerer 

- Leonard Rosenthal, Aladdin Systems 

''Without Resorcerer, our localization efforts would look like a 
Tower of BabeL Don't do product without itr 

- Greg Galanas, CEO and President, Metrowerks 


"Resorcerer's data template system is amazing. 

- Bill Goodman, author of Swxiller I ns taller and Compact Pro 

''Resorcerer Rocks I Buy it, you will NOT regret it.” 

- Joe Zobkiw, author of A Fraginent of Your Imagination 

''Resorcerer will pay for itself many times over in saved time and effort” 
” MacUser review 

''The template that disassembles 'PlCT's is awesome!” 

- Bill Steinberg, author of Pyro! and PBTools 

'Resorcerer proved indispensible in Us own creatUmr 

- Doug McKenna, author of Resorverer 






I 


Version 2,0 


The Resource Editor for the Mac™ OS Wizard 


ORDERINQ INFO 


Kequires System 7.0 or greater, 
1.5MB RAM, CD-ROM ‘ 

Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, PCs, or Visa/MC 
Taxes: Colorado customers only 

Extras (call, fax, or croail us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 

MATHEMAIISTHETICS, INC. 

PO Box 298 

Boulder, CO 80306^0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440-0504 
resorcerer@mathemaestheticsxoin 


• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Re sorcerer Apprentices (€FM plug-ms) 

• New AppleScript Dictionai'y (‘actei Apprentice Editor 

• MacOS 8 Appearance Manager-savvy Control Editor 

• PowcrPlant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big> little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 


• Fully supported; iPs easier, faster, and more productive than KBsEdil 

• Safer meniory-based, not disk-file-based, design and operation 

• Al! file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and open s/m arks/s elects resources by text conleni 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 
“ Includes nearly 200 templates for common system resources 

« TMPTiS for Installer, MacApp, QT, Balloons, AppIeEvent, GX, etc. 

• Full integrated support for editing color dialogs and menus 

■ Try out balloons, Tetb’s, lists and pop ups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


Tb order by credit card, or to get the iat^t news, bug fixes, update^ and apprentices, visit our website*^ 

www.mathemaesthetics.com 













Visionaries, innovators 

your operating 



O Wi' All Rifjhiv tea.Tit.tl. Tit Afifsk liVij. iMaL iinil giiickTinh? air rr^IrniiiiluaiKl RtiikT hA 

iwltmifi irf CiimtiLijt!!. Ith. Jbta a tratk-mati e/Simi Wli-ni*]rsinm, liir .Ni^inifr Na^^jpdii- \i, a imknask stf WE^3(3ipc 
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(MiHT fWtilihrtH mhI ttimpwif rruf io!,kiiu!Fiu iif itiwr n:-,'«pr<iiivi‘ 
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Introducing Mac OS 8. 

Superior performance, Multi-tasking, 
Unparalleled customization, Integrated Internet tools. 

No barriers. 


and futurists, 
system has arrived. 


You’ve always liacl a vision. And ro .see that vision 
llirough, you’ve always used your Mac* OS 
computer. The only 1(K)1 for the job. Now with 
Mac os 8, your ux)l just got a whole lot shar|)er. 

\Kint to accomplish more in less lime? 

Mac OS 8 makes it happen with performance. 
Increased performance in the form of our 
multi-threaded Finder'” .software that lets you 
accomplish .several tasks at once, like opening and 
copying files without any waiting around. Once you 
launch Mac OS 8 you’ll notice a new 3<iimcnsional 
look that’s even easier to work with. Spring-oi)en 
folders, contextual menus and pop-up windows are 
a part of Mac OS 8’.s new navigation and 
tustomi 2 ation features that let you organize your 
system to match your intlividual work style. And 
Mac OS 8 has integrated Internet capabilities. Tools 
like Netscape Navigator™ the PointCast 
Network, Internet Explorer, Marimba 
Castanet Tuner and a new Internet 
MSC OS Setup Assistant are built right in. 


Personal Web Sharing allows you to use your 
computer as an intranet web server. And built-in 
Java™support lets you download and run Java 
applets on your desktop without having to launch 
vour brow.ser. All this continues the Mac OS 
tradition of helping you work the way you think. It 
even includes QuickTime’ multimedia technology, 
Wlial’s more, Mac OS 8 an read Windows files, 
whether you have the original application or not. 
It’s also txtmpatible with most of your existing Mac 
applications. Mac OS 8 is designed for 68040 and 
PowerPC"^ based systems, and features reliability 
improvements that’ll have you glad you went with 
the(X)werof8. 

You have what it takes to create your 
own reality. And with Mac OS 8, you can create it 
without l>arrieis. 

Visit http;//software.apple.com/macas8rcv 
for a list of kxol .software resellers 
or a free demo. Or give us a ring at 
1-800482^376 ext 1560. 


_0L 






continued from page 8 

* T-aurich the Edit application. 

* Type die text NSLocalizedSuing, 

* select the text, then select the Services menu, Header Viewer 
submenu. Find item (Alt-Shifl-H). 

The HeaderViewer app wilt do a search and find the 
selected routine in the various precompiled headers (in 
HeaderViewer, select Info/Prefercnces to see the list of 
precompiled headers to be searched). Wlien we used this 
technique to seaa'h for NvSUK:alizedString we get: 

j'Mefine NSLacallzei^Stri ng tkey ■ comment) \ 

_ f[NEBundle malnBundle] iocaiizedStringForKeyj(koy) 
vaiue:^"* table:nil] 

Jdeflne NSLocalliedStringFroitlTable(key, tbl, comment) \ 

_ [ [IJSBundle mainBundlel localizcdSLringFarKey: (key) 

value table i (tbl)] 

ifdefine NSLocalizedStringFromTablelnUiiindletkey. tbl, bundle, 
camuient) \ 

_ fbundle locallaedStrliigForKey: (key) value 
tables(tbl)] 

These three routines are the keys to IcK'ali/Jng your strings. 
NSLocalizedString takes a key and a comment, biAh of 
which are NSiJtrings. When ProjectBuilder encounters a call of 
NSLocalizedString, it uses the key and comment to build an entry 
in the file Loc'alizable.strings, Kerens an example: 

KSString ^untitled = N5LocalizedString(§"lINTTTI.ED^ 

§"Name of new, untitled document"); 

This piece of code defines an NSString pointer named 
untitled, which gels the string retrieved by the call of 
NSLocalizetiString. The NSLocalizedString call takes two 
parameteni, both of them INSStrings. The first one is the default 
value of the string. In this case, the default value is “UNTTH^ED". 
The second NvS.String Is the c<jmment that leads off the entry. 
ProjectBuilder will use this line of crxle to generate this entry in 
the file Localizulile.strings: 

r Name of new, until led documcni 7 
*&UNTITI.ED" - -SUKTITLED": 

Note that the first parameter to NSLocalizedString serves as 
lK)th the left and right side of Uic pseudo-assignment statement. 
Instead of cmixfdding the string ©"UNTITLED" directly in your 
code, pass it as a parameter to NSLocalizedString (or one of the 
other routines well look at in a sec), then use the NSString 
returned by NSLocalizedString instead. 'Ihink of 
NSLocalizedString as a bottleneck routine. By using it, your 
strings will automatically lx: exported into a .strings file. Once 
your strings are exported into a strings file, you can hand tlie file 
to your uiinslator, then place tlie kx'alized copy in the 
appropriate )OOCJproj directory. Remember to tell your translator 
to translate the right hand side t>f all the assignment staiemencs 
only. The left side provides the link to die NSlxx:alized$trmg call 
in your code. If your default language is English, the left side of 
the assignment statement in each .strings file will also be in 
English, as will all the first parameters to NSlx>cali2edbtring, The 
right side of each assignment statement might be in German, 
French, Swedish, Kanji, whatever. 


By the way, though the comment and assignment 
statement might look like straight C code, it Is actually intended 
as an NSStringTalile. Just thought you'd like to know. 

Tile function NSLocalizedStringFRiniTable takes a key, table 
name, and comment, key and comment serve die same purpo.se 
they did with NSLocalizedString. The table name is an NSString 
dial specifies the name of an NSStringTable in which you'd like 
this entry stored. For example, this call will create an entry in the 
file FindPanel.strings. 

NEStrina * untit led “ KSLocali’.£cdStringFroHiTable( 
fainter Find String;*'. 
f^Flnd Panel’** 

^"Progipt for Find panel"); 

Wliy n(X stick all your strings in kxalizable.strings? One 
approach used by OPHN.STFP programmers is to create <jne .strings 
file for each panel/window in their interface. If your application 
.supported a find panel, an Info panel, and a main window, you 
miglit have three .string^l files: KindPanelstrings, InfoPanelsirings, 
and MainPaneLstrings. You might choose to keep all your strings in 
IaK!£ilizable.strings or not use Lcxalizahie.strings at all 'ihe point Is, 
NSkx'ali/etLStringFromTable is designed to let you store strings in 
the .strings file you chexxie. 

Ihe second parameter to NSLocalizedStringFroniTable 
assumes the .strings suffix. So passing in the NSString 
©TindPanel” will store the string in the file FindPanel.strings. Of 
course, if you create more than one .strings file, you'll liave more 
tiles to manage and to pass on to your translator, so make the 
design choice that's right for your situation. 

'leniiinology note: ©"mystring" asks the runtime to 
create a temporary NSString object with the specified string 
and pas,s the reference to wherever it is used. 

Finally, NSLocalizedSlringFromTablelnBundle lets you do 
die alxjve but from a table associated with a bundle. Bundles are 
like plugins — well get to them in a future column. 

Tnj. Next Month,,. 

Your homework for this month: Add some 

NSLocalizedString c<ills lo the VerySimple'lext a]>plication diat we 
built two months ago. You can add the code to the 

AlxjutWindowControiier class, inside the s1k)w methixi. Check 
out the .strings files generated by ProjectBuilder in resfXJn.se to 
your additional code. Dt> you see when these files get generated? 

In Digital Librarian, open the bookshelf 
/NexiLibrary/Bookshelves/DevTools.bshlf Spend some time 
with this bookshelf, and pay special attention to Part 2: 
Creating the Interface. It has documenis that descril>e creating 
a nil) file, creating menus, initializing text, and tons more. 

See you next month! B 
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Aladdin 

^Sy^s 


Transaction 

PROCESSINB 


Best 

CjdMPRESSiDN 

Available 


Installation 


SCI^IPTiNB 


CONriBURATlbN 

Support .a 


• CUSTOM 


DESTINATIONS 


The reiLS(»[i we call I iislallerMaher 4.1 the SB 
H Cumplete [ns^tafhitkm Solution h berau:^ 
jp we include fVrn thing JOU n(M‘d to prepare a H 
professional package of files for instaliation on your^H 
users' machines* An installer, updater, and an 
uninstaller are just three components tneluded for the 
same price one of (mjt line competitors charges for 
just the insUdlcn And we've just abided ^ 

B] electronic transactions, ShrinkWrap, and 
K/ improved internet configuration support, Bf 
m Using our installer reduces technical support IB 
calls due to end-user errors during installatioii, B 
saves disks (if dislrihuling on floppies) or (Icwnload 
time (if distributing on-line). And the puzzle will be 
solved. VouTl have every piece in place* 

Download a frcf, fuUy*functional copy of 
Installer Maker 4 J fro m www*aiaddiiis>^*com, or 
I call (408) 7H1 -(>2{K} and iLsk for Developer 8ales*, 


• SHRINKWRAP 


• BUiLT-lN 


• MPROVED 


NTERNET 


jun 


Resdurce 


COMPRE^aiaN 


I£507 AiArirtln Syfltepwi, (nr (fi!i Wnsfridoc! Diiw, WaTaonviJk!. CA Fax: {4001' B2D6 
Internet. dev.salesijBtec»clr®ys oom AC.VL. Ap09l ink Al ATHUN. Siufflt InstallerM^iKw iaa linflrmn* 
ol Ataddin Systems, loc. Ol^^r prexiucts ars tractemfliks ol tl^ raapecTive hoidiefs 










by Marcelo Lombardi 


Using Apple Guide with PowerPlant and MacApp 


About the Appiegoide Framework 
The prxivided Apple Guide frame^vork 
can lx used to minimize die o;xle-writiT^ 
effort required to incorporate Apple Guide 
into MacApp or PowerPlant applicadoas. Ir 
includes support for coaching views, panes, 
and dekmlt context-checking classes for Ixrtli 
frameworks. Two examples are provided. 
This article, was divided into four main 
sections: (1) Understanding the framework; 
explains tlie components of tlie Apple Guide 
Framework; (Z) Using the framework: 
provides an overview of die sample 
appliaititjns tliat are available on-line; 0) 
PowerPlant example: shows how to use die 
framework to incorporate Apple Guide in 
PowerPlant applications; (4) MacApp 
example: shows how to use die framewoiii 
to incorporate Apple Guide in MacApp 
applicatit>ns; (5) Creating a guide file: 
pnjvidcs very simple introduetJon U> writing 
guide files. Tliis article assumes a Irasic 
knowledge of PowerPlant and/or MacApp. 


RliQUlKIiMLWlS 

Code Warrior 9 or higher, and either 
MacApp 3 3 or PowerPlant 

Understanding the Framework 

I'he framework is composed of three 
sets of classes (’see Figure 1). Fiist, the 
Apple Guide dassc^s implement tlie RXjuired 
toollxjx initialization calls, detemiine the 
availability of Apple Guide, manage coach 
and context replies, open and elcxse the lie Ip 
window, and teniiinate the Apple Guide 


session. Secondly, the utility classes aie veiy simple classes tliat 
implement common programming tasks. !n this area CASWorld gels 
the current A5 and restores the global A5- CHandleLock, locks and 
restates the state of a liandle. COSType is a class implementation of 
the OSType data type, and converts chart's to OSTypes and 
viceversa. CProcoss olitains infomiation alx)ui the current process. 
Finally, if you are using PowerPlant, CBroadcasterWindow 
broadcasts a message to tell its listener when it l^ecomes active or 
inactive; TBroadcasterWindowMA act'omplLshes the same funt:tion 
using MatApp's dependency mechanism. 


In this section, a brief overview of the AppleGiiide, and the 
MacApp/PowerPlanl subclasses will be provided. 


CApfileGuItteEX I 

CAppleGtjlife 1 


Apple Guide 


I CCoachHandler 


t- 1 CContextHandier I 


Litilitiefi 


MacApp/ 


CASWorIct 1 
CHandleLock I 

COSType ~| 
CProo^sEx \ 

^ 1 CProccss I 


CCoachHancftefliflacApp | 

CCoachHandlerPRtant 

CContextBandlerMacApp ) 

CCqrrteictHandlBrPPlanl | 


LWindiow'H CSnadeastetWinckiw^ I 
_ I TWindow~H TBrQEKjcastefWrndowMA | 


Figure L Apple Oiikle Fmmemrrk CkLSS Tree. 


Your application will only ewate one CAppleGuide ohjea, I'o 
create ir, you must initialize ii by calling Initialize with the name of 
the Apple Guide tile and the Ibur-byle identifier of die context 
handler. Initialize calk InstallCcntextHandler and InstallCoachHandler 


Marcclo Lombardi is a development consultant at Software Concepts, Inc. Marcelo welcome.s coments at his internet address: 
marceIo@sol1ware<onceprs,com. You can also check our his WWW home page at http: //www, software-concepts .com. 
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which installs the context-checking and coach h^Jiidling pTocedunes 
respectively> InstallContextHandler calls AGInstallContexlHandler 
pas-sing a reference to the CAppleGuide olijea, InstallCoachHandler 
calls AGInstallCoachHandler passing a reference to the CAppleGuide 
object. Now, when the static proc pcjinters ReplyToContexl or 
RepjyToCoach are oiled, they can use lire reference to the 
CAppleGuide to call DoReplyToContext or DoReplyloCoach, “Ihis is 
done for two reasons: Fiist, you need lo be able to disp^itch the ail I 
to the current reply object associated with the frontmcxsi dcx:umcnL. 
Secondly, it pnjvide a means for mimicking a ‘"virtual proc pointer”, 
should tlic need for overriding CAppleGuide ever arise. Firuiliy, 
SetCoachHandler and SetContextHandler install the appropriate 
coach-handling and context-handling objccLs dcjKmding on wliich 
window is in front. Here Is tiow this works: 

// 

// Replying mechaoimi from CAppleOnide.cp 
// 

// RtplyTijOxieh dispatehes ihe tail lo ihe vinual nicmlKT 
// DoRcplyToQiadi 
pascal OSErr 

CAppleGuide::ReplyTnCoaebtReet* pItemRect* ?tr pNamen long 
risfCan) 

f 

OSEct result = kACErriteraWotrouud; 

CA5World anA5Woi:ld: 

CAppleGuide* anAppleGulde - (CAppleGuide*) refCon; 
i f (anAppl eCtiicifi) 

I 

if(anApplcGuldc >DoReplyToCoarh(pName, pltemReut)) 
result = noEtr; 

I 

return(result): 


// DoReplyToCuerii lets the appmpriate tC;oadiHandlcr { potiaps the t>nc assoicatcd widi 
// tke ftontnwst docunoent) handle the reply 

Boolean CAppleGuide::DoReplyroCoacli( Ptr InNamr!, Rect* 
ioIteraRect) 

( 

iftfCoachHandler) 

return fCoar.hHandler->DoReplyTnCoach( inHame. 
ioTtemRectJ: 
rcLurn false: 

1 

// 

// Header file CApplc<juide.h 

It 

class CAppleGuide 

t 

public: 

/ 

// eunstruuktn/de^truetMjn 

CAppleGuide 0; 

virtual '^lAppleGuide(); 

void Initial lKe( Str656t inHatne, OSType inContextID) r 
//API 

virtual void OpenGuideO: 
virtual Boolean IsFrontProcess (); 

void S et Co achHendle r(CCo achHand le r ' inCoa c hHand1e r); 
void SetContextHandlerCCGontextHandler ' inContextBandler); 

// Accessor (can we nm apple <juide ? ) 

BoDlean GanRunO : 

protected: 

virtual void GetProcessInfoO : 
virtual OSErr InstallContextHandler(): 

virtual OSErr InEtallCoachHandler(); 


X Q: What does it take 
0 superior client/server/ 


A\ A SUPERIOR 


STAfiT with the 
most advanced client- 
side SDK on the 
market: c-tree* Plus 
at $895. 

• C^nmplele “C” Source code 

• ROYALTY FREE 
(Oliuttl :Sido) 

• Muliiplc supported 

I proltrtxjts 

• Fast, portable, reliable 
- Powerful Features like 

imnsaciion processing 

• Win^5, N1'. und 
Windows ready 

^ I M JI 

AOD a strong, 
multi-platform, 
industrial-strength 
Server that supports.” 

• File mirroring 

• Heterogeneous networking ^ 

• Automutic disaster recovery 

• Mullj-threaded design 

• Best price/perfdrmance 
avfiEkhle: From $44.'i $3741 


€^jl 

L ^4^*- 


RESUf ^ 

A solid, econam jai 
easily deployable 
product that fits 
your needs. 

* Portable 

* Scalable 

* tvxceplional PerfooimTCt: 

* Flexible 

■ Easy Server dtslribuliun 

■ Convenient OEM temis 

FAIRCOfVr 

Server 


MAC 

Heteroger^eous 
TCP^P Ni^Uwork 


You can't Find a batten efient SDK with these features! 
Over sixteen years of proven reliability and performance, 
one cise supports over 30 plotforms in this price range! 


c-tree Plus® 

• Ccmiplele C Sfiurce 

• Sin&lc/MuUi User 

• Clifinl/Server (opbon^l) 

• Full ISAM lanctionaUly 

• No Royal li es 

• Transaclion Processing 

• I^ed/Variable Ijangth Records 

• High Speed Data/Index 
Cflching 

• Batch Operations 
» File Mirroring 

• Mulliple Qnitexis 

• Unsurpassed Ikjrtabilily 


FairCom® Server 

• Clienl/Server MfKiel 

• Transaction Prjjecssing 

• Rttiuifes c2Mll RAM 

• Online Backup 

• Disaster Recovery 

• Rollback - Forward 

• Anti-Deadlock 
ResoluLion 

• Clicnl-side "C* Source 
- Multi-threading 

• Heterogeneous networking 

• File Mirnmug 

• OEM/Source Available 


FOR YOUR NEXT PROJECT CALL FAIRCDM: YOU 
CANT FIND A BETTER HETEROGENEOUS 
CLIENT/SERVER SOLUTIDN! 

Also inquire about these FairCom products: 

d-tree™ 
r-tree® 
ODBC Driver 


FAIRCOM* 

ICORRORATIOINJ 


Since 1973 

^WWWob Address: http://www.rsirc(iii.canv' 

aoo-a 34 <s'iao 

U.S.A. phone (573) 445-6833 fa>i (573) 445-9698 
EUROPE phone (035) 773-464 fflX (035) 77S-806 
JAPAN phone (0592) 29-7504 fax (0592) 24-9723 


• HPaOOO * RS/eODO • sun O/S 4 .x 


October 1^97 • MAdTECH 
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static pascal OSKrr ReplyTcContext{ Ptr plnput, 

Size inputDataSize. 

Ftr *ppOutput* 

Size ‘pOutputDataSize, 

AGAppInfoHdl MppJnfo }: 

static pascal OSKrr RcplyToCoacM Rect* pIleniRccL. 
Pt-t pNanie. 
long ref Con ) i 

//You can ovcrridt: IXiRcpIyamJ/ar IXiRiplylU^:^ htil 
// it bi better if you sut^iasi! (^CoacliHatidier anU/ttr 
// CQ>nttfxrKandIer 


virLLial Roolcaii DoRcplyToConicxt ( eons l AEKvenLlDS 
inRventlD, 

const OSTypei inID)t 

virtual Boolean DoReplyToCoachC Ptr inNamen 
Rect* ioItetuRect) : 


pr i rate: 

Boolean 

ProcessSarialNuflibBr 

FSSpec 

AGReftauin 

AGRefMtim 

AGRefNum 

OSType 

CCoachHandlor * 

CContext liand 1 g r ' 
CProcess 


rCanRuri: 
f Procesa^tuiiber : 
tCuideSpec; 
tAGRetNum; 
fAGCoachRefKum; 
f AGCotitextRefNuai: 
fContextTD; 
fGoactdJaudler: 
f ContEKtilandler: 
fProcess; 


Now is limt* to look Ai the Coach reply objects. 
CCoachHandler is the; l)iistf-c:ltiss and it is used to coiieh :iny item 
for wliicli yc^u can pass their rectangle and their identifier, 
CCoachHandlerfVlacApp can be used to coach any MacApp object 
that is a sulx’las.s of TView, CCoachHandlerPPIanl on lie used to 
coacli any PowerPbml object that Ls a subekss of LPane. 

Coach handlers don't require any initialiscation steps. All 
you need to do is call the overloaded method InsertObject for 
every object ihaE ytiu want to coach. DoReplyToCoach will 
handle the coaching reply. Notice that the insertion of panes 
and views i.s defined in the subclasses CCoachHandlerPPIant 
and CCoach Handler MacApp. hikewise, the subclasses oveiTide 
DoReplyToCoach to iniplenient the appropriate reply. Also 
notice that InsertObject can be called with a pane^ a view, or 
a pair<Recl, OSType>. *lT(e items are inserted in S'l'L list.s and 
reintwed at destruction time. It is also important to know' ihal 
when you insert TViaw objects and LPane objects the 
conversion of coordinates is handled automatically. If you 
need lo insert a pair<Rect, OSType>, yon need to handle 
coordiaiite eoiiversion yourself. 

I [ere is the lieader file for CCkja chi land lei' 


virtual void IrsortObject(const pair<Rect, OSType) ^ 
iiiltem): 
protected: 
private: 

list, i paif r<Rp!Ct. OSType) (i oTtom) > fit eras; 

]: 


Context handlers work similarly to coach handlers. Unlike 
coach liandiers, howeveq liicy do ncjt recjuire tlie insertion of any 
visual objects. Context handlers receive events and respond to 
thcjse events. For example, yon may want to know if the 
application is the front process, or if a w indow is in front, or if a 
previous step was perfonned before attempting to coacli an item. 
In this "minimalist’' type of framework only front-window 
checking for both PowerPknt and MacApp is provided. Here are 
the coniext-checking classes. 


// CContextHandlerPPIant, in CContextHandier.h, abstract supercla.s,s 
class CGoncCXIHandlet 
t 

public: 

// CotLsiruciiou/dcsiaiLUoti 
CContextHandler(): 

V i rtua 1 "^CCnntextHand 1 er (); 

// Must override 

virtual Boolean DoRuylyToCoQLexL ( const AEKveritlD& 
itiKveritlU, 

const unsigned long& inlB. 

CAppieGuide “ iuAppleCuide) *^0; 
static enum OSType 1 klsFrontWindow ^ 'isffl: 

1: 

// C’QmtcxtHandlcrPPtant, in CContcxtHiindlcr.h 

class CContextllandlerPFlant: public CContextHandler 

I 

public: 

// 

// (xiosiruLiitni/dt.'itruetion 

// 

CCoiitextlJandlerPPlautO : 
victual “CContextHandlerPPiani0 : 

// ijvcrridc It) expand capabiUticii beyond froni-window checking 
virtual BoolGan DoReplyToContext ( const AEEventlD& 
i nEvetitTD, 

const unsigned longfi InIFh 
CApplcGuide* inAppIcGuidel; 

[: 

// (XnmcxiliatidierMacApj}, in (XxuucxiJiandkTli 

class CContextHandlerMacApp: public CContextHandier 

I 

public: 

// CoiiMnk:linn/dc?^triK:lH>n 
CConTexTitandl erKacApp () : 
virtual "-GGontexLHanJlcrMacApp{) : 

// override to exjximl eapabilities bcTond friun-window ehceking 
virtual Boolean DoReplyToContext( const AEEventlD^i 
InEventlD. 

const unsigned longi inID, 

CAppleCijidfl"* tnAppleGulde) ; 

]: 


class CCoachHandler 
i 

public: 

// C'onstrtiOion/dciiinit^ion 
CCoachllaritllGr {): 
virtual “CGuacbRandltfr (); 

virtual Boolean DoReplyToCoach( Ptr InName, Rect* 

ioltemRect): 

//An 

#ifdor _PoworPlaru_ 

virtual void lusertObject{const LRane* InPane)] ] 

^eiidif 

/lifdef qMacApp 

virtual void lusertObjact(const TVlew* inView)i 1 
fendif 


CCojitextHaudler is iin iihstrua siipcirks-s tlial su()plics tlic 
bask interface in DoReplyToContext interhice unti it is inipleinented 
in CContextHandlerMacApp and CContexlHandlerPPIant using the 
Mac App and PowerPkni APIs. You c!iin use the code as an 
example of haudliag context checking so tltat you can create your 
own code. 

Using the Framework 

This section shows an example of how to use the framework 
with MacApp and PowerPlant. 
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macworldexpo/ 
or call: 80II-64S-EXPO 


Wf ith so many products available lo boost 

performance and creativity, your Mac has never 
liad more potential than it does today. See the 
best and latest of these enhancements at 
MACWORLD Expo/Boston! 

The prodticl offerings at retail stores are no match 
for the breadth of choice you'll find at MACWORLD 
Expo. Catalogs may offer variety, but no opportunity 
to see demonstrations or ask questions. Only 
MACWORl.D Expo lets you experience the full scope 
of Mac computing, with thousands of solutions for: 

• Web site design and Internet navigation 

• publishing, enlerlainment and multimedia 

• networking, enterprise-wide connectivity, 
and intranets 

• education. R&D, research 

• business and telecommuting 


The Mac universe Is 60 million users strong. Rub 
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that are free to all attendees. Learn from the experts... 
keep abreast of trends., maximize your Mac 

investment in more than 80 conference sessions. 
MACWORLD Expo opens your mind to new 
horizons accessible only through your Mac. 







































Figure 2 shows the example application. Full source code is 
available on-line for MacApp and PowerPlant. 



figure 2 Aj[^le Guide Example appHcaHon. 


This example shows four different coaches: a coach for 
tile format box, a coach for the color popup menu, a coach 
for the quantity field, and a coach for the Beep menu item. 
The behavior of this appUcation Is minimal as ii aitempis to 
minimize the amount of code used and make it easier to find 
the Apple Guide-specific code. 

First of all, lets try the application. Launch either example 
application, and open the guide file by either clicking on the help 
icon, or selecting Open Guide from the Example menu. In Sample 
Guide windoid, select die Coaching lixamples topic and click the 
OK button. Follow the directions and you will see each 
view/pane being coached. Notice that if the ApplcGuideExample 
application is not in front, cjr iLs window Is not open, you will get 
a message that reads: “Please make sure that your application's 
window is the front window^ before using this guide.'' This is 
accomplished by using context checking. You should now lie in 
good shape to see how die Apple Guide code is integrated in a 
PowerPlant and a MacApp application, MacApp programmers 
who are not interested in PowerPlant feel free to skip this section 
and jump dia-clly into the MacApp example. 

Poi^FRPLAJVr EXAMni^ 

The Startup method of the application object creates an 
initialized instance of die CAppleGuide object. For convenience, 
fAppleGuide is a static variable of the docuimenr object, 
CAppleGuide expects the guide file lo be called SampteGuide and 
to l)e in die same directory as the afiplicaLion file. If anything 
goes wrong (can't find the file, Apple Guide is not available, etc), 
an exception will be thrown, and the program will simply beep. 

void 

CPPExampleApplication::StartUp{) 

[ 

// create iind initblixe guide 

CPPExatDplcOoeuincnl:: TApploGuide = new GApploGulde; 

try 

1 

if (CPPHxampleDocuiiient:: fAppleCuide) 

CPPExanipleDocument:: fAppleGuide>Initializet”\pSainpieGuide''. 'AG 
CT'): 

I 


catch(CAppleGuideEx ex) 

I 

::SysBeep(l): 

1 

catch(CProcessEx ex) 

( 

::SyfiBeop(l): 

) 

Ob eyCoiDJiiand (cjnd^Neu, nil); // create a new window 


At destruction time, CPPExampleDocument:ifAppleGuide is deleted, 
the Apple Guide session is terminated, and the guide is closed. 

CPPExampleApp lie ation::~CPPExarop1eAppiication t) 
i 

if(CP PEx amp1e Do c umen t:ifAp p1eGuid e) 

delete GPPExampleDocuinent r: f Appl eGuide; 

} 


Let's now take a look at the constructor of the document 
object. Only three parts are Apple Guide specific and they have 
been commented appropriately. First notice the creation of 
fCoachHandler and fContextHandler Secondly, the call to 
((CBroadcasterWmdow*)mWindow)->AddListener(thjs ); is used to 
tell the document when the window becomes active or 
inactive. That way, when the widow becomes active, we can 
set their fCoachHandler and fContextHandter data members as the 
current handlers of the static objea CAppleGuide. Finally^ a 
reference to the format, qiiantiiy, and color panes is in,serLed 
into the coach-handier ol)jccL. The references are used to return 
the appropriate coordinates to Apple Guide, when the user 
selects a specific topic. 

CPPExampI eDocument:: CPPExampl eDociitnent t LCommander * inSuper, 
FSSpec ‘inEileSpec ): 

T.SingleDai:! ( InSuper ),fDirty(0) 

[ 

Try^ I 

raWindow “ LWindov::CreateWindow( 1000, this ): 
fCoachHandler = nil; 
fContextHandler = nil: 

// 

// Create coach and contexi handlers 
// 

fCoachHandler = new CCoachHandlerPFlant; 
fContcxtHandler ^ new CContextHandlerPPlant: 
ThrowIfHll„{mWindow): 

ThrowIfHll (fCoachHandler)i 
TbrowTfNil_(fCQntextHaririlet): 

StCqlorPenState siatti; 

FenNormaiO : 

RGBCoior color - [0. 0, 01; 

PenState aState: 

GetFenStat:e(^aSrate) : 

LPat ntAtrachtnent’ bl ackAttachtnent - new 
LFaintAttachiDonL (^aSLaie, &color, fiicolor, nil); 

LPane* line = mWindow >findPanGByTD{'line'): 
ThrowIfNil^tblackAttachment); 

ThrovIfUll.dlne): 

lineOAddAttachment (blackAttachment) : 

LEntron* help = (LButton* )°iWlndow‘>FindPaneEyID {* guld *) ; 

ThrowTfNl1_(hGlp}: 

help >AddLlsteller {this ) : 

// 

// The documeni treeds lo know when the window becomes 
// aaivc or imtctlvc. 

// 

{{CBroadcaaterWindow’*) mW1 ndow)'>AddListenEr(this ) : 
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LPane* format ^ inWindov‘>FirtdPaiieByID( ^ FRMT'); 

LPsne* clr ^ iBWindow->FindPaneByID(*COLR'): 

LPane* qtty = aUindoTtf'>FindPaneByID('QTTI'): 
LStdRadioButton * radiol = 

{LStdRadioSutton MinWxndow>FiTidPaneByIDf (OSType)l) : 
LStdRadioButton * radio2 " 

[LStdEadioButton ‘) mWindow - >i'indPanGBy ID ({OSType) 1) ; 
LStdRadioButton * radio3 ■ 

{LStdRadioButton *)mWiiidov->FindPanoByIDt{OSType)1); 
ThrowIfNil_(forHiat); 

ThrowIfNil_(clr); 

ThrowlfNll_(qtty); 

ThrovIfNii^jradioI)» 

ThtowIfWil_{cadio2 ); 

ThrowIfWil (tadlo3): 

fRadioI = radiol; 

fRadio2 " radlo2; 

fRadio3 ■ radio3; 

fQuantity = (LEditFleld*)qtty: 

fColor * (LSldPopupManu*)clr: 

// 

// We need to insert the format, a>Ior, and quaniy panes 
// in this docnmcnt's CiJuch handlcr/lhe Beep menu item is 
// handled automatical ly by Appietiuide. 

// 

if(fCoachHandler) 

I 

fCo3chHandler~>InsertObject (forinat}: 
fCoathHandler->InsextObject(cir): 
fCoaehHandl8r‘>Insart0bject(qtty); 

I 

ICatch^f InErr ) 
f 

SysBeep(1}: 
return: 

J EndCateh._ 

if ( inFlleSpec nil ) { 
this >HainoNowDoc (): 

1 else [ 

thia->OpaiiFile( VinFileSpec ): 

) 

mUindow-)Show(} : 

} 


Now lets see what happens when the window becomes aaive. 

void 

CPPExamploDocumont;:LifltnnToMossage (HessageT inMessage* void 

'iDpttraln) 

I 

^pragma unused(ioFaram) 

switch^ inMessage } 

I 

case cjnd_0penGuide; 

f 

this->OpenGuide(); 
return: 

1 

case cnid_Beep: 

[ 

SysBeop [1); 
return: 

\ 

case CBroadcaaterWindov:;activate_ID ; 

( 

if( fAppleGuide 3 

I 

fApp1eGuide->E etCoachHandler CfCoachHand1er): 
fAppleGuide->S etContextHandler(fContaxtRandler); 

] 

return: 

J 


case CBroadtasterWindoTif; :deactivate_ID: 

[ 

if( fAppleGuide ) 

[ 

fAppleGuide >Sg tCoachHand 1 er(nl1): 
fAppleGuide->SetContextnandler(nil); 

I 

return; 

1 


1 

The c(xle is very simple. If tlie window iiecomes inactive, 
the IiandlcTS should be nil, If the window becomes active, the 
document's handler should be the one replying to a coach or 
context check message. Finally, the c:all to OpenGuide is very 
simple and it is invoked when the user selects a the Open Guide 
menu item, or clicks on the help icon. 

void CPPExaTnplaDocument::OpenGuide[) 

t 

try 

I 

if UAppieCuide) 

fAppleGuide->OpenGuide[); 

1 

catch(CAppleGuideEx ex) 

I 

SysBeep(1); 

1 

} 


Macapp Exampij? 

Hello, MacApp adventurers! The code was developed in 
MacApp 3.3, and it can be convened to new'er and older versions 
of MacApp with relative ease. If you looked at the PowcrPlanl 
example (and PowerPlant is an easy game for MacApp 
adventurers), you will notice a lot of similarities in the code. In 
any case, we will go through the MacApp code without assuming 
you tliat you read the PowerPlant sect ion. 

The lAppHcationMAExamplemclhod of the application object 
cTcatcs an initialized instance of the CAppleGuide object. For 
convenience, fAppleGuide is a static variable of the document 
object, CAppleGuide expects the guide file to be called 
SampleGuide and to be ki the same directory as the application 
file. If anything goes wrong (cant find the file, Apple Guide is 
not available, etc), an exception will be thrown, and tlie program 
will simply beep. 

void TApplicationMAExample:iTApplicationMAExample{} 

f 

this'>IApplication(kFileType,kSignatur e); 

// tpeate and initialise guidt; 

tDociuncntMAEKUmple:: fAppleGuide = new CAppleGuide; 

try 

I 

if (TDocumentMAExajnple: : fAppieCuide) 

TDocumentHAExample:;fAppleGuide’>Initialize t 
'*\pxSainpleGuide'*, 'AGCT") : 

1 

catch(CAppluGuideEx ex) 
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t 


t iSysBtJcpd): 
r^jturn: 

1 

catch(CProcessEx ex) 
1 

1:SysEeep(I); 
return: 

I 

) 


Al dcsLrucLiun limti, TDocumentMAExample::fAppieGuide is 
deleted, the Apple Guide session is icrminaLcd, and the gniile 
is closed. 

TAppiicationMAExatapie::‘^TApplicationMAExatiple() 

I 

if (TDocutiientMAExainple: :fAppleCylde) 

delete TDrtryment MAKxampl (2:: fApplcGuide: 


Let's now take a look at DoMakeViews in die document 
object. Only three parts are Apple Guide^specific, and they 
have been commented appropriately. Hirst notice the creation 
of fCoachHandler and fContextHandlen Tliey are not static 
because each document has its own pair of handlers. 
Secontiiy, the call to aWindoW'>AddDependent(this); is used to 
tell the document when the window^ becomes active or 
inactive (TOroadcasterWindow^MA has this capability), Thai 
way, when die widow becomes active, we can set their 
fCoachHandler and fContextHandler data members as the 
current handlers of die sialic ohjeci CAppleGiiide. Finally, a 
reference to the format, quantity, and color views is ioseited 
into the coach-handler object. The references are used to 
return tlie appropriate coordinates to Apple Guide, when the 
user selects a specific topic, 

void TDoouraentHAExampI iDoMnkeV I cws (Boolean /‘forPrialitigV] 

//Override 

i 

TWiiidow* iiWindow = nil: 

TStdruiiitUandier* aHandler ^ nil: 

TViev* aView - nil: 

TFicture * aGuidePict = nil: 

aWindow = &ViewSf^ rver - >NevTornp 1 i oWi ndow (kMAExtiinpleWiridowlD. 
f.hl Fi): 

FaiiNTl.CaWindow J: 

aVioi*i = aWlivdow >FindSubVigw(’A€EX‘): 

// 

// lto>mc ^ dt pctideiit of TllnRidca.sitrWiiTdowMA so wc im: noLjlied 
// when ihc wind<iw uctivc or inactive 

// 

aWitidow - >AddDGpen{1eiit ( Ch 1 s): 

// 

// Find ol>(ects to fx- coached 
// 

TView* format aWlndow >FindSubView("FEMT*}: 

T?iew* color = aWindow->FindSiihV3cw{'COLR'] i 

TView^ quantity aWindow I ndSubView ('QTTY') t 
FailNTlTforinat): 

Fal1 NIL(color] : 

FailNlL(quantity): 
tCglor = (TPopup*)color: 
fFormat ^ (TCluster*)format; 

fQuantlty = {TNU[iiberTftXt‘')quariT ity; 

fColor >SetCurrentItem(fCol orVal. kRcdraw): 
fFori 0 at->Sr!r.€urrcnTChoice trForniaLVal); 
fQuanttiy >SciValuctrQuauliLyVal. kRedraw): 


lIsiMG Apple GutOF wnit PowfrPukt ami MacApp 


// 

// In.Mall context handler, coach handler, and ohjects to be coadied 
// ( mejiQs are handled automatiodlv and do not need to be inserted ) 
// 

fContextHandler = new CContextHandierMacApp: 
fCoachHandier ^ new CCoachEandlerHacApp; 
fCoachHandlerOlnsertObject(format); 
fCoachHandler'MnsertObjRet(color) : 
fCoachHandler->InsortOb|ect (qiiantity): 


Now lets see what happens when the window becomes active. 

void TDocumentMAExample::DoUpdate(ChangelD theChange, 

TObj ect* changsdCbj ect, 

TObjeci*^ chan&odBy* 

TDepoudencySpare* dspendencySpace ) 


TBroadcasterWlndowMA ^ window - 
MA_DYNAM I C_CA ST (TB r o ad c a s t e r Wi nd owMA, ch a n ge d By): 

TPicture * picture = MA DYEAMTC„CAST(TPiclure» changedBy); 
if(!window fifi !picture) 

I 

Inherited::DoUpdate(theChange, 

changedObject, changedByn depandencySpace ): 

return; 

I 

a wit c h(the Ch ange} 

I 

case TB road ca s terWindowMA: :kAc tivate: 

I 

fAppieCulde >SetCoachHandler( fCoachHandler ): 
fApploGnide->SetContextBandlar(fContextHandler ); 
break; 

case TBroadcuFJterWfndowMA: :kDeac Livalo: 

1 

fApploCuide->SetCoachHandler( nil ); 
fAppleGuidc’>SetContextHandler (nil ): 
break: 

] 

default: 

Iiiheri ted:: UoU pdate (theChange, 

changedObject, changedBy. dependencySpace ): 
f 


The code is very simple. If the window becomes inaccive, the 
handlers should be nil. If the window lieromes active, the 
tkx’umenfs handlers .sliould Ix" the ones replying to a coach or 
context dieck niessjige. Finally, the call to OpenGuide is also 
simple and it is invoked when ihe user .selects a the Open Guide 
menu item, or clicks on the help icon. If you compare liie 
MacApp and the FowerFlant code, you will see that the MacApp 
example p)st.s a command that invokes OpenGuide from its Dolt 
method, whereiis the PuwerFlanl example handles this dimcily. 

void TBor.uiriGUtMAKxsinplR: lOpenCuidflO 
I 

try 

I 

iftfAppieCulde) 

fAppleGuideOQpenGuide{); 

1 

r;atcb(CApplRGiiidpEx ex) 

I 

SysBeept1): 


MA«frEr:H • October 1997 


20 







Order directly from web site at www.neologicxom and save $1001 ^ 

Download the architectural overview or view it on-line with Adobe Acrobat 3. o 

M-F 9 AM to sPM Pacific. 

The most powerful object-oriented database engine available i -3o l ., - : 

NeoAccess*'displays electrifying performance —up to 
ten times that of the competition* Behind its elegant 
programming interface is a fully optimized relationai 
query engine built for speed. It also has an obiect cache 
with automatic garbage collection so your applications 
can run In a much smaller memory footprint than you 
ever Imagined possible. And NeoAccess has no runtime 
fees so you pay one affordable price no matter how many 
copies of your application you use or sell. 


neo-logic' 

NeoLogk Systems, Inc. 

1450 Fourth St.. Suite 12, Berkeley. CA ?47io 
V. 510 , 534.5897 f- 5 ^ 0 . 524.4501 

rreo logic® neo to gic.com 
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Creating A Glide File 

As you can see, the framework is simple and very' easy to 
use. The objective of this article is not to teach Itow to write an 
Apple<Htide scTipl, Inii to show you how to incorporate 
Appk^luide into MacApp and PowerPlant appIicaiion.s. Tills 
.section, therefore, shows how ihe scTipi ""liLs* wath the code. 

First, let’s look at ihe coach marks section. *AGHX' is the 
identifier of ihe ii()[>lication. “FRIMT" ^ ‘’CCiiT’ , and ^QTTY'* are 
liic identifiers of tlie panes/views l>eing coaclied. They are 
received as a char* 's and the ilie gitidc uses ilie clas.s COSType 
to conven them into an OSTy|x:- Notice that this class uses hit- 
shifting operators and if you buijd a 68K project you will need to 
use 4 bytes integers in your projed settings for it to work. Also 
notice that Apple Guide handles itienus automatically, you ju.sr 
need to .supply Ujc menu name and the item name. 

# “ Ctjcli Kdrks - 

Define standard coaches for use wfrh . 

<Define Menu Coach) "Coach Heap Menu", *ACEX\ REDGIECLE* 

"Example". “Beep". RED. UNDERLINE 

<DufinR Object Coach) “Coach Format". 'AGEX\ REDGTRCLE. 

“FRMT- 

CDefine Object Coach) "Coach Color". 'AGEX'. RKUCIRCLE. 

"COLR" 

<DGfine Object Coach) "Coach QLfantfry". ‘AGEX’* REDCIRCLE. 
"QTTY" 

Now kK>k ai the context checking function IsFrontWindow, 
’AGCT is ilie context-check identUier that we used 10 in die call to 


(AppleGuide->lrLitiali7e( "\pSamplc Guide'’, ‘AGCD; Also notice 
that the Framework uses OSType identifiers fi)r event id 
rec:ogniiion in context-checking. When IsFrontWindow is called in 
tlic script, a context check event is ,scnl to the application, which 
responds accordingly. 

CDefine Context Check) "Ts^FrontWindow''. 'AGCT'. 'ACEX'. 

OSTYPEI’isft' 

Additional context-checking can be added l)y creating your 
own sulKiass CContextHandler. 

Last Word 

This article tries to be as concise as pcissihle. Gel the code 
and see how it can help you in your own development. Flay with 
it, and make your own improvements. ITie "Apple Gujile" classes 
(see figure 1) t:onmin tlie most relevant ccxle. It should Ik‘ fairly 
straight forward to incorporate Apple Guide help in you 
PowerPlani and MacApp applications. Have Fun! 
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by Nicholas C. '"nickx” l^eMello <onHne@mactech.com> 



BtlLDlNG A BifTTliR ReADMe 

You just finished your latest program and realized that tlie 
average user will never discover three of the new features on their 
{;wn (or at least not appreciate the advantage of those features 
witliout a little explanation), 'lliat same user will find out tliat ytxir 
program is mcompalihle with seven shareware system extensions 
that you couldn’t accommodate, and tliai user will send you e-mail 
alx)ui each one — separately. It's time to create your release notes 
(creatively tillcxi "KeadMe"). This column lists a few online resources 
to make building your ReadMe just a little easier. 

Keep it Simpij^ 

Most release notes are distributed as documents of the type 
""ttro” and creator "'ttxt" — SinipleTexi read-only documents. 
Originally, TeachText, Simple'Fext is that small text editor that 
gets added lo your hard disk with every Apple software 
installation. Various groups at Apple enhanced TeachText to 
make ic a better vehicle for their particular technologies. In 1995, 
a half dozen tjf these “enhanced" versions of TeachText were 
combined to form SimpleText, which can now create styled text, 
display colored text, play QuickTime movies, drag and drop text 
editing, convert text to speech, record sounds, play sounds, and 
has limited support for QuickDraw 3D, 

Notice I said “display colored text” — not create it. The 
easiest way to add colored text to your ReadMe files is with 
Ales.sandro l£vi Montalcini's iiimpIeText Color Menu utility. This 
utility can modify a copy of SimpleText by installing two new 
menus. Features in die new menus allow you to colorize text, 
search, search and replace, store a default text style, and gives 
you the option of opening read only documents as editable text. 

Pictures can lie added to your SimpleText docnjinents with a 
resource editor. Open the document witli ResEdit or Resorcerer and 
save your pictures as 'pici' resources (number them 1000 and up) 
into tile resource fork, Tlicn, open the dcx*ument with SimpleText 
and eater a non-breaking space (option-spacerbar, the ASCII 
character $CA) where you want each picaine to appear, SimpleText 
will draw ‘pict’ ID lOOO horizontally centered on the screen, Tlic 
lop of the picture will liegin where the first non-breaking space 
appc'ars. SimpleText will display ‘pict’ ID 1001 at the second non¬ 
breaking space and so on. Because Simplelext Ls a text cxlitor, it 
wQI only allcxiate enough space on the screen for die non-breaking 
spiice character (not the picture), you will liave to add sufficient 
wliitc space to make sure the picture doesn't overlap text. Apple's 
technote ltX)5 (liy Bryan Steams, revised by Mark Cookson), “The 
Complete Guide to SimpleText,” provides a detailed description of 
fine art <jf importing ‘pict' resources into SimpleText documents. 

Download PICTify by Scott A. Johnson to help you collect 
those ‘pict’ resources. PICTify is a system extension which allows 
you to grab saeen shots (cropped as you take them or of the 


whole screen). In addition to lieing able to take screen shots with 
menus down, PICTify has a feature to allow you to grab only the 
contents of the foremost window—^ideal for taking quick pictures 
of dialog boxes. Best of all, PICTify allows you to save your 
images as either picf files or ‘pict’ resources. 

SimpleText is not able to save doaiments as ttro’—but that 
is how Apple recommends you distribute your release notes. 
ITiere are a number of utilities for changing file types, but I'm 
particularly fond of a freeware utility called “TEXT <-> itra.'' It 
toggles files dropped on it between “TEXT" and “ttro*’ types, and 
causes the finder to immediatley update the icon (something 
many type utilities fail to do), 

SimpleText 

<ftpi//s wu pdates. info.applecom/Apple. Sup port. Area/AppleSoftware. Updates/US/ 
Macintosh/U til i ties/S i mpleText_ 1.3, sea, hepo 
Alessandro Levi Montakini, author of SimpleText Color Menu 
<http://persoweb.francenet.fr/- alm/> 

Technote 1005: The Complete Guide to SimpleText 
< http: //gemm a. a pple. com/dev/tec h note s/t n/r n 1 DOS, htmi> 

Scott A. lohnson's PICTify 

<ftp ://m I rrors. ao! .com/pu b/in f o- m ac/gst/grf/picti fy-15, hqK> 

TEXT <-> ttro by Laurence Harris 

<ftp://m] iron aol xom/pub/info-m ac/text/text-to-ttro.hqx> 

Beyond SimpleText 

Stmplelexi isn't your only choice for creating distribution 
documents. Mark WiilTs feature rich DOCMaker is the standard 
for creating stand-alone, self-nmning document files, DOCMaker 
allows you to add liyf^ertexl, pop-up graphics, startup-splash 
screens with sound, and even lets you import RTF files. It's 
cjverkill for a ReadMe, but when you find it's time to start 
including a manual witli your application, this is the right tool. 

Marco Piovanelii is ^e auclior of the WASTE (WorldScript- 
awarc Styled Text Fmgine) library. Ihis powerful text editing engine 
lias lieen mcorpomied into many text editors, and appropriately 
enough into Marco's own answer to SimpleText. Piovanelli's 
scriptable Style editor lets you paste graphic's fR>m yriur cliplxiard 
within slylcxl and colored text, then save those documents as stand¬ 
alone self-running documenLs, as read-only Simplel'ext, KIT, or 
your choice of over a dozen word pitKcs-sing formals. 

DocMaker 4.S by Mark Wall of Qreen Mountain Software 

<hrtp://www.hsv. t i 5. net/-g reenmtn/> 

Marco Piovanelli's Style (also the WASTE — Wo rid Script-aware Styled Text 
Engine — Library) 

<http: //www.kagi. com/authors/piova net/> 

These and other links are available at the MacTech URL 
database <http://www.macte€h.conri/magaziri€/urts/>. 
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TOOLS OF 
THE TRADE 


Rich Morin 


Why Mklinux? 


Or, js grep realty worth 
500 MB of disk space? 


So What/5 MkUnux? 

MkLinux is a fK^it of tlie GNU System to 
the Power Macintosh. Jt provides a UNix-like 
user and programming environment, witlt 
hundreds of useful commands (software 
development and doaiment preparation 
Ux^ls, network servers and tools, and odicr 
utilities. With very few exceptions (e.g., tlie 
lx»ot code), all t^f tlic source ccxle for 
Mklinux is freely redistributable. 

The Mklinux port is based on die 
Linux 2,x kernel, wliich is used as a 
“single server” for the Mach 3 
microkernel, i'hus, the Linux kernel runs 
as a user-mode process, liandling OS 
“personality'* issues, while the Mach 
microkernel handles low-level I/O and 
resource allocation tsLsks. Tliis two-part 
de.sign has assorted benefits, including 
the ability to debug a new Linux server 
fas an application) while running the 
system on a older (trusted) server. 

Because Mklinux has pre-emptive 
multitasking and runs as a “native” OS, it 
makes quite efficient use of the Power 
Macintosh hardware, A Power Mac 6l00, 
for instance, is capable of serving as the 
local "‘UNIX box” for a dt>xen or more 
casual users and programmers. Aside 


from providing access to the normal range of unix tools, 
MkLinux supports a wide variety of network services, 
including FTP, HTTP, NFS, Telnet, and the X Window System. 

Once a Mklinux system has booted, if is “just" a Linux 
system, 'fhal is, it has all of tlie standard Linux user and 
programming interfaces, system administration tools, etc. The 
big difference, how^ever, is that Mklinux is running on an 
integrated hardware platform, Ccmsequently, Mklinux system 
installation does not lose the adniiniscrator in a twisty maze 
of DMA vector and IRQ settings, jumpers, and other Intel- 
specific annoyances. 

HISTOKY and CtJHRENT STAIUS 

Altliougli MkLinux has been under dcvelopineni for a few 
years, it has only been available to the general public for a 
short while. Apple's first public announcement coneerning 
Mklinux was made at the Free Software Foundation's First 
Conference on Freely Redistributable Software (Febmary 
1996 ), Since that time, Apple has issued several Mklinux 
Developer Releases. DR3| for instance, is expected to be 
available by the time you read this article, 

Mklinux has never been a large-scale project for Apple 
Computer Staffing has never exceeded five engineers, split 
between Apple and 'Fhe Open Group Research Institute. The 
MkLimix Reference Release, aldiough sponsored and assisted 
by Apple, was pn>duced by Prime lime Freeware. Tlirough 
the efforts of volunteers, large numbers of applications and 
drivers appear on Mklimix-related FTP sites. If Linux is the 
system where “everything is done by someone else”, MkLinux 
is certainly well in line with this tradition. 

The Mklinux user community is served by email lists, web 
sires, and other Internet-based facilities. ITie email lists are quite 
active; more than 5000 subscribers are currently registered. They 
handle Mklinux announcements, setup and programming issues, 


Rich Moriti <rcint@ptfxom> Ls the editor of “Mklinux: Micmkerrtel Linux for the 1*owct Macintosh", published by Prime lime 
Freeware (www.ptf.com). A 30-year veteran of the computer industry. Rich writes for both SunExpert and UNIX Review 
magazines. His home system is a lltree-headed Power Macintosh 7100/80, running Mar OS. It is, however, networked lo several 
loc'al UNIX (Mklinux and SunOS) boxes. 
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utc\ Thv liigh signal'to-noise ratio of the lists reflects the 
cooperative attitude of the MkUnox community. The Apple 
Mklinux web site <http://www,mklinux,apple.com> ccmuiins 
announccmcnus, news, online help, and pointers to otlier 
internet-based res4>urre,s. 

Who Uses MkJjniix? 

The Macintosh is very popular in academia, whether in 
computer Labs, professor’s offices, or dormitory rcx)ms. By 
making Linux available for the Power Macintosh, Apple allows 
these academic insLilulions (and rtssociated individuals) to make 
l>etter use of existing hardware. For instance, a computer science 
graduate snident might write a device driver for MkLinux, then 
switcli back to Mac OS to create the diagrams and write up a 
paper describing it. 

As hinted above, Mklinux is also finding use as a network 
server. NuBus-hiised Power Macs are not considered very 
powerful by today*s standards, but they peribnn quite well as 
Mklinux servers. In fact, a Power Mac: 6100/60 is roughly 
equivalent in performance to an early Sun SparcStation 5 or a 90 
MHz Pentium system. If the 6100 is already on hand (or cheaply 
available), it can lie an economiol and very convenient 
alternative to an Intel or Sparc-based system. 

Wt! are also starting to see quite a bit of interest from the 
Apple developer comnumiiy. Developens have been quick to 
realize that Mklinux pmvides a very economic-al way to Icxik at a 
Mach/ifNix system on the Power Macintosh. Iktler yet, txHh the 
source code and a large Ixxly of reference imteriaLs are available. 

Apple’s original inoiivaLion in sponsoring Mklinux, by the 
way, came frtim its Higher Education sales foree. It seems that 
they got tired of hearing about the fact that Intel-based PCs were 
more versatile (running both Windows and Linux). So, when the 
Mklinux skunk works projecl got slaned, the Higher Ed folks 
were quick to support it. 

MkLinux Basics 

If you are already familiar witii Intci-based Linux systems, 
feel free to skip dow'n to the next section: a runnitig Mklinux 
system is essentially indistinguishable from a running Intel-based 
Linux system. If you have used otlier UMX-tiased systems, all you 
need to know is that (Mk)linux provides extended versions of 
most traditional BSD anti System V commands. 

If you^re still witlj us, you're probably wondering how much 
of a letirning curve youYe facing l>efQre you can lie a pnxlutlive 
Mklinux user and prtigrammec As usual, the news Ls mixed: the 
Ixid news Is that it could lake you years to learn everything alxsut 
the entire system, Uie gtxxl new,s is that you (xtn master the bisic's 
in a few hours and that you don’t really need to know' everything 
alxjut Mklinux to lie (tuile productive on it. So, lei's get smited... 

Like MSTX)S, Mklinux has a iximmand-oriented user 
environment. Although X Windows provides the ability to run 
graphical applications, it does not have the pervasive GtJldrased 
semantic's, let akjne the consistent user interface guidelines, found 
in Mac O^. 1 fence, Mklinux windows tend to Ixf **glass teletypes", 
used to communioite with a command line interpreter. 


Unlike MS-DOS, however, Mklinux supples several 
command line interpreters, or “shells”, along with hundreds of 
shell-oriented commands and little languages". By combining 
these either on the comrmmd line or as saved “shell 

scripts”, you can make Mkijnux do some pretty amazing things. 

Let's say that one of your diretiorics ctmtains several 
flundred files, each of which contains one or more C routines. 
You want to ltx)k at some examples of how the routine "*100" is 
used, so you ask the Mklinux "grep" command to take a look: 

rdnii@mklinux 1: grep foo *.c 
bar.c: x - foo(...); 

baz.c: y = foodpU .,): 

haz.ct z = £ao(..J : 

Althougli the first line ltx)ks just fine, the .second line shows 
that we weren't sufficiently precise in our searcfi. So, we use the 
“-W” flag to tell grep to look for the “word" foo: 

rdini&mkliiiux 2: grep 'W fOC 
bar.c; x ^ foo(..,); 
baz.c: z - foo(.» J : 

There seem to lx: c:|uite a lot of matching lines, however; 
let's just get a list of die file names: 

rdin§mklinu)t 3: grep -Iw foo *.c 

bar.c 

baz .c 

How many fifes are there? Let’s ask the Mklinux word couni 
(wc) utility for a cxxini: 

rdfo^klittux 3: grop Iw Ioq | wc -1 
42 

Now let's supfxise tliat we want to txipy all of the matching 
files off to a separate directory, for detailcxl examination and/or 
1 IKxlification. Mklinux lets us do this %rery easily: 

rdni^kHnux 4: mkdir hax 

rdni#mklinux 5: Cp grep -Iw foo *.c' hfix 

There are tiundrc-ds of commands in the Mklinux repertoire, 
yielding a staggering numlx.T of combinatioas. And, because 
setiuences of commands can be saved as “sliell .scripLs”, tjcaling 
new commands is a trivial process. Mklinux shells liave most of 
the common progratiiming constructs, intludijig variables, control 
flow operators, etc. If you want tnore |>rogramming pt)wer, 
however, you can always drop into a language such as awk or perl. 

The creation and (re-)use of simple commands is 
fundamental to the Mklinux way of doing things. ILither than tiy 
to create monolithic programs that can do every conceivable 
task, Mklinux programmers create small, general-purpose took 
and combine diem into task-specific commands and scripts. 

In the example above, for instance, cp has no need to know 
anything about string searching and grep has no need to know 
anytJiing about fife copying. The combination, however, is able 
to do a rather powerful and sfx:cialized function (string-based file 
copying) with little effort. 
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Increase Yeur Seftware Sales 


WiBU-KEY™Copy Protection provides the most 
secure and flexible software protection available. 

WIBU-KEY has been protecting software around the world 
since 1989. WIBU-KEY combines the most sophisticated 
encryption technology with the highest grade hardware 
components to give you peace of mind that your software 
won't be used illegaily. You've worked hard to create your 
Mac application. Don't settle for anything less than the best 
copy protection system - WIBU-KEY. 


Hot plug 'n play ADB design 
I Network support built-in 
Protect multiple applications 
or program modules 
Secure Remote Programming 


• Consistent API for Mac and 
PC development 
User-friendly setup and 
diagnostic tools for your 
customer 
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Email: sales@ 9 rift 0 ch.com 


www.grinecli.com 
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I Tel: +49-721-931720 • Fax: +49-721-9317222 

Email: info@wibu,d0 
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Legal Issues 

A.S an Apple deveioper, you are prol>al>ly familiar with 
CCC, GDO, GNU Emacs, and other tools that have emer^jed 
from the GNU Projet:L As an implementation of the GNU 
System, MkLinux ajiitains hundreds of these tools. In 
addition, it includes a great deal of BSD (Berkeley Software 
Distribution), Mach, and X Window System code. In sliorl, 
MkLinux is a compilaiioii of compilations, including a variety 
of software and associated legal restrictions. 

Software developed by the GNU Project is (almost alway.s) 
covered by the terms of the GNU General Public licence (GPL). 
In addition, many programs developed by third [parties (e.g., 
GhosiScript and Perl) are also available under the GPL, 'I hiis, if 
you plan to use Mkl.inux (or any other GNU software), a basic 
understanding of the GPL is advised. 

The GNU GPL allows both non-<'ommercial and commercial 
distribution, in either source or binaiy' format, of materials it 
covers. It requires, however, that distributors of f>inary code 
make the source code economically available, upon request. It 
also prohibits any other resiricLions (including colleaion 
copyrights) from being placed on the materials. 

Thus, although you are free to examine, modify, 
redistribute, and use GPLed cotie, you are not free to turn it 
into proprietary code. In general, software developed using 
GNU tools is not affected l)y the GPL. save that tise of hl>raries 


may \:ontaminate” developed code. For detailed information 
on the GNU Project and the GNU GPL, see the GNU wel) site 
<http://www.gnu.nrg>. 

Much of die remaining freeware in tlie MkLinux distribution 
Is covered by ** University-style" licenses, such as those used by 
CMU, MI'i; and UC flcrkeley. These licenses retjuire that the 
sourc’e ccxle retain a notice showing its origins, but say nothing 
resiriciing the codecs inclusion into cotiimercial products. 

Finally, you should expect to find a few *Tini(]uc" licenses, 
ranging widely in iKJth style and terms. You are on your own 
when dealing with these notices. Altliough the.se hcen.ses 
normally allow free use within a given organization, their lenn.s 
for distribution may prohibit external distribution, even for 
non-commercial purposes. So, be sure to read the fine print! 

Porting Iss ues 

Because MkLinux is closely based on Linux, it is able to 
build most Linux source archives with little trouble. The 
problems that do surface lend to stem from basic art:liilectural 
incompatibilities sucli as byte ordering or the need for 
particular hardware. Ftoaliy, because of the Mach-based 
internal structure of MkLinux, IJnux driver code docs not port 
at all trivially. 

Most Linux programs are written in an architecture- 
indepentlent inamier. At worst, they contain a few #ifdef 
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stalcmcnLs. A few Linux programs, however, make assumptions 
about the ordering of bytes within words, etc. Because PowerPC 
CPUs address differenUy than Intel CPUs, this can cause 
prt>grams to malfunction. There is also an assumption, on Intel- 
based platforms, that variables of type char are signed. MkLinux 
assumes that chars arc unsigned, but a compiler option can be 
u,scd to change this assumption. 

If liic stmree code comes from another variant of Unix (e.g., 
BSD or System V), things can get a bit trickier. Although most 
iiKtx system calls and library furtcrions are standardized, each 
flavor of irNix tends to have a few unique (or modified) 
interfaces. Linux is quite popular, however, so you should 
expect to find Linux-oriented #ifdef statements in most common 
freeware packages. 

Porting non-trivial software from Mac OS, on the other 
hand, is likely to ^x^ a real challenge. The Mklimtx system calls 
and library functions have many of the same capabilities of Mae 
OS routines, but their exact nature* names, and calling 
sequences are apt to to be very different. Be prepared to look 
up a lot of funaion dermitions! 

Worse* the event-driven mcxiel favored by Mac OS 
applicatioas is not found in most MkLinux programs. Some 
window-based applications may be written in an event-driven 
manner* but that's about it. And, although X may look a bit like 
the Finder* it is a radically different environment, sharing few 
of the Finder's basic; assumptions and rules, fn shon, you 
should treat MkLinux as a Linux system that happens to run on 
a Power Macintosh, rather than a weird variant of Mac OS. 

MkLinux Resources 

As noted above* MkLinux is well served by email lisLs, 
FTP sites, and web servers* The lx.‘st starting point is Apple's 
MkLinux web server <http://www.mklinuK*apple.com>. look 
around this site for general information* late-breaking news* 
mailing lists* online help* and links to related sites. As the 
MkLinux community grows* volunteers will take up more and 
more of the burden of disseminating MkLinux-relaled 
informatic^n* hut the Apple web site is likely to remain as the 
best starting point for any search* 

The Linux community is well served by printed 
documentation, software collections* and online information 
resources. With the exception of some kernel- and hardware- 
related material, most of these resources are quite applicable 
to MkLinux. More generally* much of the linix literature Is 
relevant to MkLinux. After all* MkLinux is basically a free 
version of umx. 

All modesty aside* however* the definitive work on 
MkLinux is “MkLinux: Microkernel Linux for the Power 
Macintosh" (Prime Time Freeware* 1997, ISBN 1-881957-24-1* 
$50 MSRP). This Apple-sponsored product combines a 360- 
page introductory and reference manual with a MkLinux 
distribulicTn CD-ROM and an HTMlT^asedreference CIVROM, 
covering Linux* Mach* NeX'f* and the Power Macinitish. For 
more information, visit the Prime 'lime Freeware w^eb site 
<http://www.ptf.com>* B 
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CONTROL 


by Dave Kelly, Symantec Corporation 


Software Test Automation and the 
Product Life Cycle 


ImplemetUing software test 
in the product life cycle 


The PLC and AmoMAiiiD Tist 

A product's stages of development are 
referred to as the produci life cycle (PLC). 
'Iliere is considerafile work involved in 
gelling a product through its FLC. Software 
testing at many companies has matured as 
lessons have been learned alxiut the most 
effective lest methodologies. Still, there is a 
great difference of opinion about the 
implementation and effectiveness of 
auiomated software testing and how it 
relates to tile PLC. 

Computers have taken over many 
functions in our society that were once 
‘"manuar operations. Factories use 
computers to control manufacturing 
equipment and have cut costs enormously. 
F.letirt)ni(>i manufaauring use computers to 
test everything from mktoeieclronics to 
circuit card assemblies. Since automation has 
been so suct^sful in so many areas, does it 
make sease dial a software program should 
be used to test another softwate pnigram? 
'this is referred to as “automated sofm^are 
testing'’ for tlie remainder of this article. 

Software testing using an automatic test 
program will generally avoid ilie errors that 
humans make when they get tired after 
multiple retietitions, The test program won’t 
skip any tests by mistake. The ie.st program 


on also record the results of the test accurately. The results can 
be automatically fed into a dalaljase tliat may provide usefiil 
statistics on how well the software development process is going. 
On the other hand, software that is tested manually will l>e tested 
wiili a randomness that helps find bugs in more varied siaiations. 
Since a software program usually won't vary each time it is mn, it 
may not find some bugs that manual testing will. Automated 
software testing is never a complete suhsiilute for manual testing. 

There has been plenty of debate about the usefulness of 
automatic software testing. Some companies are quite satisfied 
with die developer testing his/her own work. Testing your own 
work is generally thought of a.s risky since you 11 l>e likely to 
overlook bugs that someone not so close to the code (and not 
so emotionally attached to it) will see easily. As stKin as the 
developer says it’s done they ship it. The oilier extreme is the 
company that has its own automatic software test group as well 
as a group diat tesLs die software manually. Just because we have 
computers does that mean that it is cast effective to write tests to 
test software and then spend lime and resources to maintain 
them? The answer Is l)Oth yes and no. When properly 
implemented, automated software test can save a lt>L of lime, 
time that will be needed as the .soft ware approaches shipping. 

Ibis is where the PI.C comes in. How effectively you make 
use of the PLC will often be dependent on your programming 
resources and the length of the PT.C. Companies large and small 
struggle with software testing and die PLC. Hopefully, this 
discTission of the PLC should help you determine when to use 
automation and when manual testing is preferred. Tins should 
help yoit answer the question,s: “Why should I automate my 
software testing?” “How can I tell if automation is right for my 
product” “When is die best time to develop my test software?’’, 

Tue Prodljct Life Cyof 

A,s we discuss die use of automated and manual testing, w^e 
nec'd to understand what happens in each pliase of die produa 
life cycle. Ibe PLC is made up of six major stages, the Design 
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dkelly ©eanlilink. net, 
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Phase, the Oxle ComplcLe Phase, the Alpha Phase, the Beta 
Phase, the Zero Defect Build Phase, and ihe Green Master Phase. 
You t:an think of the FLC as a timeline showin;^ the development 
of a software pnxliKi. These are the major milestones that make 
up the Produa Life Cycle, iVtKfiicis that follow these guidelines 
for implementation of the PLC will have a moth lx:iLer chance of 
making it to market on time. 

llie implemcntiilit>n of the l^LC varies widely from company 
to company. You can use tliis as a guide for future reference to 
assist you in your automation effoits. Your implenieniaLion will 
vary from die ideal PIC dial is dismissed here, but your software's 
success may dej:)end on liow well youVe implemented its PLC* If 
your I^IC is to inclutle autoimted testing you should py attention 
to w'hich auLomaied tasks peiformed during eacli pJiase. 

For eacli pliase we’ll describe it, define its special imfxiiTance 
and dist'uss how to ina>rponite Miftwam automaiion into your 
[irojed. .M(xst other disciissioas of the PLC don t include the lessons 
learned alxjut lest automation* This should Ix" your “one-stop’* gtiide 
to help you know how and when automation fits into the PLC. 

Desk;n Phase 

Wbal is ihe Design Phase? Tlie design phase begins with an 
idea* Produa managers, QA, and E)e\'elopmeni get together at this 
jxiini to determine wliat will lie included in die product* Planning 
is the essence of die design phtise. Begin with the end in mind and 
with a funalonal speciTication* Write dowm all of your plans. What 
will your product do? What customer pniblems does ii solve? 


Incorrectly, some companies don't include QiiaUty 
Assurance (QA) in die design phase* It is very important that QA 
l>e involved as early as possible. While developers are writing 
ccxie, QA will he writing tests. Even though QA won't really have 
the total picture of the product, they will want to get as much of 
a jump on diings as ixissible. Remember, that the primary 
purpt>se of QA is to report status. It is inifKirlani to understand 
the prcxiuti’s .status even early in the Design Pliase. 

f5 Ibe Design Phase important? If you think you're 
too short on time to write up a func tional description of your 
prcxJuct, then consider the extra time involved to add new features 
later on* Adding features later (especially once the Ccxie Coiiipleie 
Phase has been readied) Ls kntiwn as Teature creeps Feature 
creep can be a very costly liapliazard way to develop your 
product, and may materially interfere with delivery of tlie software* 
Atilamatiott activity da ring the Design Phase. As soon 
as the functional spedficalion is written, create all test cases so 
that they can be run manually . Yes. that's right, manually! These 
iiLmual tesLs are step-by-step "pseudo” code that would aUow 
anyone to run the test. The lx.*nefiLs of this approach are: 

1. Your test cases can lie ciTeated BEFORF* ever seeing die 
software's user interface (LID. It is too soon to automate tests 
at this point in time, but you can create manual tests with 
only a small risk of changes that will cx'c'iir . 'ITiis is a point 
of giear fnistmtion for thexse who have tried to iniplenieni 
automated test ,st:ripis tixi early. Just as scx>n as the test script 
is written changes in the til are bound to Lie introduced and 
all the work on the script is found to be for nothing. 

2. Wlien (not iO the cckIc^ is mcKlified. you will always have 
manual procedures that ran Ix' adapted to the change more 
quickly than an automated test script. This is a great way to 
guarantee that you will at least have tests you cran perform 
even if automation turns out to not be feasible. (Note: one 
of the objections tci softwaix^ test auiomation is that the tests 
must Ixf continually updated to reneci changes in the 
software* These justifiable objections usually stem from the 
fact that automation was .started itK> early.) 

3. M’est methods can be diouglii out mucli more completely 
because you don't have to Ix^ concerned with the 
pit)grauiming language of the automadan tcxil. ITie learning 
curve of most autumaikm UkiIs may get in the way of 
writing meaningfu] tests. 

If you liavc ihe resources available, have them Ixgin 
training on the test ttxils dial will lx used. Some memlxrs of the 
team should start writing libruiy routines iliat can be u.sed by all 
the test engineers when the start their test axiing. Some of Uiese 
routines will coasist of data collection/result reporting tools and 
other common functions. 

Alter the manual test ca.ses have Ixen carated decade with your 
iminagcT which test c:ases shoiikl lx automated. Use die Automation 
Checklist found later in tins anit le to assist you in deciding what 
tests to auEomitte, If you liave ent>ug]i inanptiwer you may want to 
fiave an te*st plan team and an auiomation team. Tlie lest jiLm team 
would develop tej^s manually and the automiitiun team would 
decide wliich of the manual lesLs should be am automatically 
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You know you need it. You know it has 
to be flexible and secure. And yon don*t 
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applications into locked, timedimited 
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Features 

• No source code modifications required 

• Automatically locks data files to run-time 
database solutions 

• Works with all leading installer tools 
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date, number of launches, unlimited demo, 
and expiring to “nagware” 

• Authorization options include senalbation, 
machine-unique password, and uncopyahle 
key diskettes 

• Customizable text inessages for user dialogs 

• Adds registration information capiiirc to 
your application with no coding 

• Available API lor use with “non-application” 
components, such as system extensions 

or plug-ins. 
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Visit our Web site at: 

v'w 

Vox; 408-297-7444 
Fax: 408 297-7441 
E-Mail: sales@paceap.com 


Price listed is for IntcrLok Stand,ird/3tKH) edition 
itnnuaJ license. Sec PACE web site for other prices. 
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(following the guidelines of the Automation Chetrkllst later in lliis 
article), llie automation te;im would Ik.^ rcsfx>asiblc for itssuring that 
the text can l>c successfully and cost effectively automated. 

Sometime during the design phase, as soon as the design is 
firm enough, you II select the auiotnaiion l(X)ls that you will 
need. You don’t have Lo decide exactly which tests need to l3e 
auU)tnated yet, but you shotikl have an idea of the kinds of tesLs 
that will lx: jx^rformed and the net:es.sary cu pa hi lilies of the totjls. 
'Ihat deiernimation Ls easier as die software gets closer to the 
ccxle complete pliase. Your budget and available resources will 
Ixgin to eonie into play here. 

For just a moment, let’s discuss some of die cunsiderations 
you should use in selecting the test locals you need. You'll also 
want to keep in mind the Autoimtion checklist later in this 
column, it will help you determine if a test should l)e automated, 
'lliere are a few giKxl lesdng icx>!s including Apple Computers 
Virtual User (VTJ) (See the .September, 19^ article “Sr>ftwarc 
Testing Widi Virtual User’, by Jeremy Vineyard) and Segue’s QA 
Partner (Segue is pronoynt:ed ""Seg-way”). 

Is lliere a IcH of y.ser interface (Ul) to test? Soltware with a lot 
of Lfl IS well suited for automated black box testing. Hewever, 
some important considerations are in order liere. You need to get 
involved wiili development early to make sure that the Ul can be 
'^scen’* by the automation tool For example: IVe seen prograiiLs 
in which a Virtual User 'match’ task (note: a Utsk is what a 
command is called in Virtual User) couldn't find the text in a text 
edit field, fn those oises, this occurred because the program 
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didn't use standard Macinuxsh calls, but radier was Ixised on 
custom libraries that pnwideii III features their own way. 

Will die automated test environment effect the performance 
or operation of the system Ixing tested^ When you’re trying to 
te-st the latest system .s^iftware, you don't want the testing .system 
ctianging the conditions of the lest. 

Is the speed that the tests run a consideration? If you’rL* trying 
to measure the performance of a system you’ll want to make sure 
that the conditions are as much like the '‘real world” as possible. 
You sliould consider the amount of netw-ork traffic that is present 
while you’re ainning your tests. Also, die s|xed of your host 
prtxessor am effeta the tinx‘ it lakes your tests to run. You should 
schedule your tests so tliat you minimize the pas.sibi!ity of 
interfering with someone else on your network. Kiifier istjlate your 
network from others or warn diem dial you will be testing and tkit 
there is a p(jssil>ility liiat their network activity may slow down. 

What kinds of tests will be performed? Tlie lower die level 
the te.sting is, the more likely while l>ox testing should l>e used. 
A gfxxl example of tliLs would lx if you have a fimerion that 
dtx's a calculation based on specific inputs. A <[iiic‘k C progmni 
that calls die function would be much faster and could lx written 
to check ail the po.ssil>le limits of the function. A tool like VIJ 
would only be able to access the function through the 10 and 
would not be able to approach the amount of coverage lliat a C 
program could tU) in this situation. 

Is tfiere a libraiy of common functions available or will you 
Iiave to write them yourself? It will save a lot of time if you don’t 
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have to develop libmries yourself. No matter how extensive the 
command set, efficient use of libmry functions will be essential 
Libraries that others have written may be useful; you can modily 
them to meet your own needs. 

What will be the learning curve for a script programmer? 
Ihe time it takes will depend greatly on the kind of testing you 
have to do and the experience of the programmer If youVe done 
your homework on the available test tcxils, you should know^ 
what to expect. Some companies even offer training courses (for 
a price) in their test software. 

Can your automation tool automatically record actions for 
you? Some tools do this, but don't expect to rely on tliis too 
heavily. Tools that IVe seen that do this end up creating code 
that has hard coded strings and tend to be organized in a 
sequential manner ratlier than by calling procedures. These 
recorded scripts are harder to maintain and reuse later. If you 
plan to use the same script for international testing, modifying 
the script will mean much more work. If you w^ant to record 
aaioas, 1 recommend that you do it only to create short functions 
and you should edit the script after recording to remove the 
unwanted hard coded strings, etc. 

Can you run AppleScript scripts from tlie Ltx>rs script language? 
Tliis is a very useful feature since AppleScript scripts are so easy to 
wiite and can add additional functionality to your test tool. 

In preparing this article, i encountered several “pearls” 
wortli relating: 

''Success in test automation requires careful planning and 
design work, and it's not a universal solution. automated 
testing should not be c:onsidere<l a replacement for hand testing, 
but rather as an enhancement." {Software Testing tvilh Visual Test 
4.0, forward by James Bach, pg. vii) 

“The quality assumnee engineers then come on the 
scene... and begin designing their overall test plan for the 
features of the product...." 

“ Ihe goal is to have the test plan and checklists laid out 
and ready to be manually stepped through by the test 
engineers when each feature is completed by the 
programmers. Each item on a checklist is considered a 
scenano and related scenarios are grouped into test cases'" 
{Software Testing with Visual Test 4.0, pg. 5-6) 

Code Complete Phaise 

Wbat is the Code Complete Phase? At this major milestone 
die code Ixis been cximpleted. The axle lias Ixx^n wriucru but not 
necessarily yet debugged. (Development may try to claim tliey aie at 
code complete even though diey may still have major coding .still left 
to do. Go ahead and let them declare the c<xle a>mp]ete, hut don't 
let diem get to Alpki until die axle ncady Ls compleiely written.) 

Why is the Code Complete Phase important? Sooner or 
later you'll have to get to a point where new code is no longer 
Ixang written, and the major effort is in fixing bugs. Development 
will be relieved to get to this point as now diey don't have to be 
as concerned with the initial coding and can concentrate on 
refining the existing produd. (This is why they will try to claim 
they are at code complete even when they are not). 


Software Test Automation akd the Product Life CvaE 


Automation activity during the Code Complete Phase 
Although the UT may still change, QA can begin writing 
Automatic test cases, 'llie tests that should be written at this point 
are breadth tests that tell the status of the overall software 
product. Don’t write tests which stre.s.s the prcxluct until you get 
close to Alpha. The product will probably break very easily. 
Some acceptance (or “smoke") tests should also be created to 
give a cjuick evaluation of the status of a particular build. Before 
reacliing the Alpha phase tliere should also be tests written to 
test the Installer, boundary (or stress tests), compatibility 
(hardware and OS), performance, and interoperability. 

Somewhere just l>efore ccxle complete, you will need to 
decide which tests should be made into automatic tests and what 
lest tools to use. Use the following checklist to help you 
deiennine which tests should be automated: 

Automation Checklist 

If you answer yes to any of these questions, then your test 
should lx: seriously considered for automation. 

Can the test sequence of actions be defined? 

Is it useful to repeat the sequence of actions many times? 
Examples of this would be Acceptance tests, Compatibility tests, 
Performance tesLs, and regression tests. 

Is it necessary to repeat the sequence of actions many 
times? (See Testing Computer Software, pg. 196 and 282), 

Is it possible to automate the sequence of actions? This 
may determine that automation is not suitable for tills sequence 
of actions, 

Is it possible to ^‘semi-automate" a test? Automating 
portions of a test can speed up test execution lime. 

Is the behavior of the software tinder test the same 
with automation as without? This is an important concern for 
performance testing. 

Are you testing non-UI aspects of the program? Almo.si 
all non-Ul functions can and should be automated tests. 

Do you need to ran the same tests on multiple 
hardware eonflgurations? Run ad hoc tests (Note: Ideally 
every' bug should have an associated test case. Ad hoc tests are 

done manually. You should try to imagine yourself in real 
world situations and u.se your software as your customer would. 
As bugs are ftxind during ad hoc testing, new test cases should 
Idc created so that they can l^e reproduced easily and so that 
regression tests can be performed when you get to the Zero Bug 
Build phase.) An ad hoc test is a test that is performed manually 
where die tester attempLs to simulate real world use of the 
software product. It Ls when running ad hoc testing tliat the most 
bugs will be found. It should be stressed that auromation cannot 
ever be a substitute for manual testing. 

Alpha Phase 

Wbat Ls the Alpha Phase? Alpha marks the point in time 
when Development and QA consider the produa stable and 
completed. 'I'he Alpha Pliase is your last chance to find and fix any 
remaining problems in the software. The software will go from 
I basically functional to a finely tuned f)rtxJuct during this f)hase. 
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Wby is the Alpha Phase impt^rtani? Alpha marks a great 
accomplishment in the development cycle. The ccxle is stable 
and the mast major l)ugs have been found and fixed. 

Automation activity during the Alpha Phase 

At this point you have done the tasks that need to l)c done in 
order to reacli Alpha. That is, you have all your compatibility, 
intcrof)erabiliry, and performance tesLs completed and automated 
as far as possible. During Alpha ycjull be running hreadih tests 
every build. Also you1l run the compatibility, interoperability, and 
performance tests at least once before reaching the next milestone 
{lx;ta). After the breadth tests are run each build, youT want to do 
ad hoc testing as much as possible. As above, every hug should 
be associated willi a test case to reproduce the problem. 

Beta Phase 

What is the Bela Phase? The prcxluci is considered 
“mostly’' bug free at this point. This means tliat all major bugs 
have been found 'Ihere should only l>e a few non essential tiugs 
left to fix. These should be bugs that the user will find annoying 
or bugs timi pose relatively no risk to fix. If any major bugs are 
found at this point, there will almost definitely be a slip in ihc 
slipping schedule. 

Automation activity during the Beta Phase 

There's no mote Lime left to develop new tests. You'll mn aU of 
your acceptance^ tesLs as quickly as possible and spend llic fumaining 
time on ad hex testing. You'll also nm comfxilibility, performance, 
interoperability and installer tef^s once during the beta phase. 

Remember that as you do ad hoc Testing every bug should 
have an associated test case. As bugs are found during ad hoc 
testing, new test cases should fie created so that they c'an lie 
reproduced easily and so that regression tests can be performed 
when we get Lo tlie Zero Bug Build phase. 

Zero Defect Build Phase 

What is the Zero Defect BuiU Phase? This is a fxniod of 
stability where no new serious defecLs arc discovered. ’I'he 
produa is very stable now and nearly ready to sliip. 

Automation activity during the Zero Defect Build Phase 

Run regression tests. Regrt^sion testing means running 
through your fixed defecLs again and verify that they are still 
fixed. Planning for regression testing early will save a lot of time 
during this phase and the Green Master phase. 

Green Master 

Wijat is the Green Master Phase? Green Master is 
sometimes referred to as Lfic Golden Master or the final 
candidate. The product goes through a final checkoyt IxTore it is 
shipped (sent to rnaiiufacturing). 

Automation activity during the Green Master Phase 

After running general acceptance tests, nm regression tests. 
You sliould mn through your fixed defects once again to verify 
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that they are still fixed. Planning for regression testing early will 
save a lot of time during this phase. 

Understanding the PLC will help you select your 
automation tools 

Peitiaps this review of the PLC is 'old haf for you. In my 
experience, reviewing the process usually helps to focus the project. 
Sinct? software test has been evolving over the years, and many 
companies have been snuggling with how to implement it, wc can 
always use alt the lielp and advice that we can geL Thcie are some 
gcKxl sources of information that will lielp. Take a look at the 
Software I'esting laboratories web site at URL <h1tp:/AA/WWitlabs,com>. 
'there are a few relevant articles in James Bach's aiduves at 
<http7A/Vww.5tlahs.corn/L^ The Stiftwarc Testing Labs ts 

mostly geared toward MS Visual Tc^t, but die QA principles involved 
are the same for any platfonn, Macintosh includetl 

This review of the PLC represents an ideal situation where 
Development and QA both buy into tills same way of doing the 
software business. It will also require some commitment on die 
part of Management to assure that each phase is supported and 
accepted. Once all of those candiiion.s, everyone involved needs 
to be foc\ised on making sure that no short cuts are taken around 
the agreed upon PLC. Hopefully this discussion has been helpful 
to you in automating your software tests. 


Glossary 

Word or phrase.,,....,....Dermition. 

Ad Hoc Testing.....Goal oriented passing through the 

produa. Sometimes to pmve or 
dbprove a notion of how the produa 
will behave. 

Alpha Test,,....^.Ihe part of tfie Test Phase of the PLC 


where code Ls complete and the produa 
luis achieved a degree of .stafiility. Tlie 
produa is fully testable (determined by 
QA). All funciionaliry has been 
implemented and QA has finished the 
implementation of the test plaas/cases, 
tdealty, this when development feels the 
produa Ls ready to lx sliipped. 


Automated Testing ..Creation of individual tests oeated to am 

without direa tester intcrveniion. 

Beta Test .....____.The part of the Test Pliase of the PLC 


wliere iiitegiation te.sting plans are 
finished, depth testing coverage goals 
met; Ideally, QA says produa is ready to 
sliip. The produa is stable enougli for 
external tc'sting (determined by QA). 

Black Box Test.._..........Tests in which the software under test is 

treated as a black box. You can't “see” 
into it. 'fhe test provides inputs and 
responds to outputs without considering 
how the software works. 

Boundary Testing ............I'esl wliidi focus on the boundary t)r liinil 

lundicioas of llie .software being tested. 
(Some of these tests are stress tests). 
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VOODOO 

The ultimate version control tool for Macintosh 


tool witi‘#ifj^tD-yse.-!3rai]Hc^ 

SiiUble for iOTl5 d dnilopm^nt cAoi,- iHcJ 

^ Swple ind.clwr maFwqeftwtoj vdiwib and ^^Vfti(y»<J^ enifr^pfoi^^ tnot Oflly sirigfe filfc) 
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^ Smooth hte^atiod wifi tvletrowedis CDdcW^irjor lUf 
SuppOft d Apptt^vnrr; ^nd AppleSrricri 
^ t^mipardoo dl lisoi ciflereoi typeitnoionfe (eu fk}) 

^ Ctnfioiiirabie feioil fie lodong (finder flag or CKffl rcKurce) 

^ Jiuptowd handkgof lx^file!sirvcljdir9tooae«limdflcidera 
^ Sigiidcant perfotn^nre improvenierits b many placss 
^ Essemial pam ^3w»fC nstn^ 


UNI SOFTWARE PIUS 
A-4232 Hagentierg Austria . 

email: veodoo®unisoft.co.at — http:^/www,iinisoft,co-at/e/|H)OClut:t5/vood&o.htmt 


Breadth Testing.— ..Matrix tests which generally cover all 

product componenis and functioas on an 
individual leasts. ‘Ihese are asualiy the first 
automated tests available after the funtlitmal 
specifications have Ix-en completed and test 
plans liave been drafted. 

Breath Testing..........Generally a gcxxl thing to do after earing 

gadic and l>eforc going out into [>ul>lic. 
Or you nviy have to take a hreaih test if 
you’re DUI. 


Bwg -...A phenomenon with an understanding of 

why it liappcmed. 

Code Complete .Phase of the PLC where functionality 


is coded in entirety; hug fixes are all 
th;it are left. All functions found in 
the Functional Specifications have 
been implemented. 

Code Free7.e --.....When development has finished all new 

functional code. This is wlien 
development is in a “l>ug fixing" stage. 

Coding Phase...Pha.se of the PLC where development is 

coding product to meet 
Functional/Architet'tural Specifications. 
QA develops test tools and lest cases 
during this pliase, 

c:ompatihilit>^ Test ..Tc-sts that check for compatibility of 

other sofbvare or hardware with the 
software l>eing tested. 


Concept Phase—....Phase of the PLC where an idea for a 

new^ product is developed and a 
preliminary definition of the product is 
established. Research plans should be 
put in place and an initial analysis of the 
competition should be completed. Tlie 
main goal of this pha.se is to determine 
product viability and obtain funding for 
further research. 


Coverage analysis........Shows which functions (i.e.» GUI and C 

code level) have l>cen touched and 
which have not. 

Data Validation .....Verification of data to assure iJiat it Ls still 

correct. 

Debug ........To search for and eliminate 

malfunctioning dements or errors in tlic 
software. 

Definition Phase..See teign Phase. 

Dependency' ...Diis b when a component of a produa Ls 


dependent on an oiiLskle group. The 
delivery of the product or the reaching a 
ceruiin milestone Ls affected. 


Depth Testing....Encompasses Iniegraiion testing, real 

world testing, combinatorial resting, 
Intei'opt'mbility and com|xrtibility testing. 

Design Phase...Phase of the PLC where functions of the 


pit kI net am written down. Features and 
rctjuiremcnls arc defined in this phase. Each 
deparrmcmt tlevelops their deputmenLs’ pLm 
and rt!source requirements for the produd 
during thus pliasc. 


Dot Release .....A major ut>dalc to a producL 

Feature ...........A bug that no one wants lo admit to. 

focus......................The anirer of interest or attivily. In 

software, fcx\is refers to tlie aaa of the 
screen where the insertion pcjint is active. 

FuncCiofial.....Phasc^ of the PLC defining modules. 

.Specifieatk>n.s.. ....Hieir implemcnLation requiremeocs and 

approach, and exp<xsed API. Each 
fuiution is sjxxrified here. This includes 
tile ex|5ecled results of each function, 

GM......See Green Master 


Green Master (GM)....Phase of tire PLC where the certificalion 

stage begins. Ail bugs, regressed 
against ihe prixlnct, mu.st pass. Every 
build is a release candidate (determined 
]>y development). 

GUI...................Graphical User Interface. 

InEnc,.....Ph:ise of tlie PLC after shipping (STM) wheie 

bugs are fixed fur interim ^e^easc^ Maintenance 
of the pmtiurf involves cleaning up bugs that 
are found after STM. Inlines aie created to 
addRiss these pn^blcms. 

Int^ration Testing...,.Depth testing which covers groups of 

function.s at tlie subsystem level. 
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Interoperability Test .. 

....Tests that verify operability between 
software and hardware. 

Ix>ad Test ... . 

....Load tesLs .study the belmvior of the 
program when it is working at its limits. 
Types of load tests are Volume tests, 
Stress tests, and Storage tests. 

Localization . . 

....This term refers to making software 
specifically designed for a specific locality, 

Maintenance Release .. 

....See Inline. 

Metrics ... 

...,A standard of measurement. Software 
metrics are the statistics describing the 
structure or content of a program, A 
metric should be a real objective 
measurement of something such as 
number of bugs per lines of code. 

Milestones «... ... 

....Events in the Producl life Cycle which 
define particular goals. 

Performance Test........ 

....Test tiiat measures how long ii takes to 
do a function. 

Phenomenon . . . . 

...A, flaw without an understanding. 

PLC. . .. .... 

....Product Life Cycle - see .Software Product 
Life Cycle. 

PrC'Alpha .... 

Pre-build 1; produa definition phase. 
(Functional Specification may still be in 
process of being cTcated). 

Product life Cycle 

....The stages a product goes through. 

(PIjC). 

....from conception to completion. Pliases 
of product development includes: 
Definition Pliase, Funaional/Architectural 
Specification Phase, Ctxiing Phase, Code 
Complete Phase, Alpha, Beta, Zero Dug 
Build Phase, Green Ma.ster Phase, STM, 
and Maintenance/lnlinc Phase. 

Proposal Phase 

....Phase of the PLC where the product must 
be defined with a prioritized feature list 
and system and compatibility 
requirements. 

QA Plan..... ___ 

.,..A general test plan given at the macro 
level which defines the activities of the 
test team through the stages of the 
Product Life Cycle. 

Real World Testing .... 

....Integration testing which aiiempt to 
create environments which mirror how 
the prcxluct will be used in the “real 
world”. 

Regression Testing . 

....Retesting bugs in the system which had 
been identified as fixed, usually starting 
from Alpha on. 

Resource ... 

....People, software, hardware, tools, etc. 
that have unique qualities and talents 
that can be utilized for a purptxse. 

Risk ..... 

....Something that could potentially 
contribute to failing to reach a milestone. 

STM ... 

....See Ship to Manufacturing. 


Storage Tests .........Test how memory and space is used by 

the program, cither in resident memory 
or on disk. 

Stress Test.....Tests the program's response to peak 

activity conditions. 

Syncopated test ......A test that works in harmony with other 

tests. The timing is such that both tests 
work together, but yet independently. 

Test Case...........A breakdown of each functionaJ area 

into an individual test. Tliese can be 
automated or done manually. 

Test Phase .....Phase of the PLC where the entire 

produa is tested, both internally and 
externaily. Alplia and Beta Tests occur 
during this phase. 

Test Plan ......A .specific plan liiat breakdown testing 

approaches on a functional area basis. 

Test Suite ....A set of test cases. 

Usability ......The degree to whkJi the intended target 

users can accomplish their intended goals. 

Volume Tests.......Test the largest tasks a program can 

deal with. 

White Box Test ......It is used to test areas that cannot be 

reached from a black box level. 
(Sometimes called Glass Box testing). 

Zero Bug Build ..Phase of the PLC where the produa has 


stabilized in terms of bugs found and 
fixed. Development Is fixing bugs as fast 
as they are found, the net resulting in 
zero bugs on a daily basis. This Ls 
usually determined when after a few 
builds have passed. This is the 
preliminary stage before Green Master. 
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TOOLS OF 
THE TRADE 


hy Edward Ringel 


CameraMan 3 .0 


^ickTime screen 
capture utility 
simplifies documentation 
and training 


Software authors soinclimes find 
end user documentation one of the most 
vexing aspects of development. Knd user 
satisfaction with your new application 
depends not only on the quality of your 
product and its ultimate ease of use, but 
also on the slope of its learning curve* 
While some programs are inherently 
complex, and the learning process is 
inherently long, good documentaTion 
and tutorials can make the training 
process less painful^ take less time, and 
sometimes even be fun. Good 
documentation and training materials 
may not he responsible for the initial 
sale of your product, Imt will heavily 
influence upgrade sales and sales of 
other lilies in your product line* 

Applications benefiting from a 
graphical user interface require graphical 
documentation. The move toward 
electronic documeniation, although 
probably Fueled primarily hy paper 
publishing costs, has as a secondary 
benefit high fidelity screen reproductions. 
Many applications now Ixmefii from built 
in electronic help systems such as 
Microsoft Help, QuickHelp as used by 
Claris, and of course AppleGiiide. 


AppleGuide is particubrly sophisticated in that reference 
material, instructional material, and outright assistance with 
tasks can be incorporated into an AppleGuide file. 

Animated tutorials of the kind that can be programmed in 
AppleGuide and recorded in CameraMan can be incTcdibly 
helpful in learning to use a product. A “movie'" of how a saeen 
should l<K>k and change during certain program actions can 
sometimes lx.* all ihafs really needed to show exaaly how to use 
a program* Creation of an AppleGuide file to do this can take 
t:onsiderable time, knowledge, and effort* CameraMan cannot 
create a Guide file, btjt it can create an animated tutorial with no 
programming effort* 


Enitji Cameraman 

CameraMan is a prodiic! that documents screen activity on 
your computer. Bec'ause this review is in MacTech Magazine, I 
am approaching this product primarily from the standpoint of the 
developer with a need to document software. Obviously, such a 
product c'an be useful in any number of documentation, 
education, and enienainment scenarios. 

Like a number of other utilities, CameraMan can perfonn a 
simple screen capture. Of greater interest, it can make a movie 
of the sc:neen activities or sequential stills, die latter particularly 
useful for slide sfiows and other forms of static documentation. 
CameraMan has three virtues: it is cheap, it is incredibly easy to 
use, and it does exactly what it says it would do. It lias a few 
failings, and with tme exception they are relative and do not 
detract from the overall value of the product. 

I obtained CameraMan electronically, over the Internet* It is 
available from <http://www.mwg.com>. It comes as an installer 
application that creates five files. First, it places the CameraMan 
extension in your system folder. Second, it creates the 
CameraMan application* Third, it creates QuickEdit, which 
permits editing of the movies created by CameraMan. Fourth, it 
creates a pdf documentation file and die mandatory Read Me 
SimpieTcxt file* 


Ed Ringel <eringel@mini.ne!> is Contributing Editor for product reviews for MacTech Magazine* In his spare time, he is a 
respiratory and critical care physician in Waiervilte, Maine. 
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The documentation indicated that the applications would 
work with QuickTime 1 -6 or greater. Although the CameraMan 
extension and application would record with QT 2.1, 
QuickRdit would not work until I upgraded my system to QT 
2.5 with Goodies. ClTiis problem has been acknowledged by 
the company and will Ik? addressed in the next maintenance 
upgrade.) After lliat, I had no difficulty willi llie product's 
perfoniiance. System 7.0, 8 megs of RAM, 32 bit QD L2, and 
QT L6 is the minimum configuration; System 75^5, I^PC 
processor, 16 megs, and QT 2.5 with Goodies 2.5 is 
recommended. Please note that I evaluated this suite of 
[products on my Performa 6200 CD with the recommended 
configuration. 1 like to think of this CPU as particularly useful 
for stress testing products since, at this fxjini, ilie creature is 
alxKii 15 months old and the PPC 603 chip that powers my 
fearless machine seems to have ended up on a dead branch on 
the evolutionary tree. 


Record It> 

From a user's standpoint, the CameraMan application is a 
control panel for the CameraMan extension. The most 
important settings are die capture senings, whit:h permit the 
user to define die size of the screen capture area, the frame 
rate, and a Quick'fime vs. PICS vs. sequential PICTs decision. 
It is possible to t:reate a capture area tFuit then "tracks" tlie 
cursor movemenLs, which can reduce memory' usage and focus 
the attention of the vieu^er. 

There are a number of advanced options regarding QT 
compression and Uie like which 1 will not review in detail; suffice 
it to say fiiey are present and extend die utility of the program 
coasiderably, especially for long, large videos. The aser can 
define the various control keys, where movies arc stored, and 
several options regarding sounds, iociuding the opportunity to 
use stylized mouse click and keytxaard sounds, 'I'he movie can 
use microphone int>ut or other audio input such as the 
computer's inlernal CD. 'Ihe user can reecinJ sounds as a separate 
soundtrack or as an integml part of the movie. On systems witli 
multiple monitors, the user can pick which monitor to record. 



Settings 


CameraMan’" 

^ Enable 

I Liyui V 

IH 

1 

s 


1 - Record SelUngs 

— ^ 


(□rmal: 1 

QuickTime^'” ▼ | 


Frainf?f/Sec.: 4.000 


Capture Mode: | full Screen 


Capture flree 


Lefi: B 

li 

night: :64ll~~ 

Ji 


Top; 


BoltPFn;i4S0 


Figure 1, The CameraMan Application main mndowshomng 
the recording configuraHon options. 


Tlic documentation for CamemMan is quite acceptable. All 
options were carefiilly reviewed and several strategies were offered 
for optimum recording. File sizes prediaed by the dcxaimentation 
wert^ Msmewhat larger than what I actually encoonteied. 

Capture of screen activity on my 15 inch screen occurred 
without malUtnction. I tried recording a narration of my activities 
along with my instmctional demo, and aside tom die I'aa tliat 
my kids laughed at me for talking to die computer and our new 
kitten insisted on sitting on my lap and purring into the mike, this 
pan also went well. Comic relief aside, the udlity works as 
de.scnlx.xl, and it was enormously ea.sy to set up. As an example 
of file size, a 1 minute, full screen capture with voice-over was 
about 10 megs. 

I liave two comments atxxiL the capture aspect of the 
CameraMan package. First, it would be great if Mot ion Works 
created another capture mode which atitomatically tracked 
and captured activity in the front window. It is possible to do 
this by setting the capture frame correctly, but 1 would expect 
that an automatic setting would be fairly easy to implement. 
Static screen capture utilities .such as Flash-It do this, and it 
would i>e a reasonable and helpful upgrade to CameraMan. 
More imponantly, initialing capture slowed other activity on 
the computer to a crawl, in fairness to MotionWorks, they 
forewarned of this, and 1 deliberately stressed the program by 
doing full screen recording. 

\ made several of the suggested alterations such as 
choosing the correct compression, reducing frame size, and 
using a solid background for my desktop, and performance 
improved. I tliink that careful thought and planning to record 
only the necessary portiT)ns of the screen would be an 
important aspect oi product use. Obviously, the documentation 
should be produced on the fastest CPU available to you. I see 
this speed issue as CameraMan's one significant problem, since 
product dottimemaLion arid tutorials often may re<|uirc full 
screen capture. Given the task at hand, ihougli, I'm not sure 
that anyone could write faster cxxle, 1 think the speed issue may 
be an inherent Itmiration of the genre. 

Practical use of the capture utility would include having die 
pnxlucer thoroughly understand the jircxlua or procedure lo be 
recorded. He or she would dien write a script of screen actioas 
and a narration (or some other form of tiackground music or 
.sound) appropriate to the situation. Then, in a quiet room 
without cats or children, tfie script would lie executed. The next 
step in prcxluciion would be to edit the file. 


Edit It... 

Editing of mcT>tdings takes place in QuickFdiL TliLs aptilication 
can edit movies and sx:)undtracks. I fieely admit diat I ;mi not a 
QuickTime niaven, but excepting a few rough spots, the product was 
more than ample fix cieating animated dotiimenis. Soundtracks cm 
be edited and applied in “layers." Animatioas also c'an l>e layered, 
and text movies that overlay .screen recordings can be created. Cut, 
copy, and paste appropriate lo tlie tasks were available. Tlic only 
gltldi that appeared was that the window showing the tracks of the 
movie I made insisted on positioning itself partially oifecreen. 
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The Ei(iicutiv-fe''s Guidfc to ttip Intcm<ctjlntran^t Worlds 



Th* Rrs« jUTd On^y VwInen'to-StisiiteH OirKftiiTf tar 
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Hi-Tech Medio, Inc. 445 Fifth Ave., 27 Fl,, NYC, NY 10016 
Tel: 212-447-6400 800-663-5421 Fax: 212-447-9177 

E-Moil: rnfol@hi-techmedia.com www.hi-lechmedia.com 


If Has Anything to Do With Multimedia 
Chances Are You'll Find It Here! 

The Self Buiknufi-to-euiiiwfi Oir«ctory 
fsp tti* HuUlhwf^ Wofidl 
Ova bjOdO fsnqwiy iBOigt. 3^ canegnw 
the Worid*s Top Quality Supplied of 
ittrvicei and Tiqulpmant In MultimadTa Today! 


The Place to Find |t! The Place to Be Found! 



Want to know what products 
are available for MacOS 
development? Check out 
Developer Depot^^ 
<http://www.devdepot,com> 


The documental ion for this application was not as gcxxl as 
for CameraMan. For example, it look a while for me lo figure out 
how to c:reate a new narration for a screen animation and replace 
the original; too much familiarity with QT was assumed. 

Ml in all, 1 w'ouldn't want to create the sequel to “Toy Story" 
using QuickHdit, but it is a very creditable product. The 
individual respon.sible for developing a software tutorial will not 
push the limits of QukkEdit, and will learn how to use the 
package fairly quickly. 

.•.Then Play It 

The las? parr of the manual deals with playing back the 
movies you have created. It addresses licensing issues and the 
use of Apple’s MoviePlayer. I would not have thought to put 
this last section in the manual, but it is a useful addition that 
will prepare the developer to write the neces.sary instructions 
for the end user. 1 used MoviePlayer to view some of my 
“tutorials” and encountered no problems. 

Tne Boitom Line 

Camera Man is a useful product for tutorial production 
and .software documentation. Consider this: the average CD 
can liold 650 megs. Your golden master has 250 megs of 
software. With a little forethought and planning, in the 
remaining 400 megs you could present a tutorial video 20 or 
50 minule.s long that eases your new user over any 
ambiguities in the use of the product. You would have 
expended no resources on writing or contracting out an 
AppleGuide file and you would have ret|uired no fancy 
production house lo make your video. I would like to see 
some portions of the documentation improved for QuickEdit, 
and 1 would like to see front window autoframing. Some 
utilities are probably better for still picture capture. 

Personally, I would like to see more software QT tutorials. I 
used I hem when learning to program the Newton, and was 
impressed with thi.s approach. 1 see this as a good package at a 
fair price, and I encourage developers to consider this mems of 
s<) ft ware dtxumentation. 

Products Reviewed 

• Camera Man’'” 3 0 and QuickEdit 2.0 Motion Works 
International, Inc. Suite 130 - 1020 Mainland Street, 
Vancouver, HC Canatla V6H 2'r4. $69.95. Windows 95 and 
Winclow NT versions due shortly. 

• MewiePlayer 2.5 Apple Computer Cuficrtino, California. 

Useful URLs 

1) <hTtp://www.mwg.com> Motion Works nn the Web. 

2) <info@mwg,com> Motion Works e-mail. 

3) <http://www.gujcktimefaq.org> QuickTime information. Mi 
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A CodeWarrior Rhapsody Update: Part One 


Berardinip £ Baratta U 
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:l^hhsbed Wiktral: h** Afactntqsh 
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■ dHdut M: fdlometert: north m/ flamhmg, 
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; ^efi: hd‘ U . mt riding Hoh^s pp ^ 
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[^kjorniah Ca^rmsi : . , 

Bob Campbell iS: (he enginer . rc^miW. 
fim^MdeOStrnd^^^^ PowerPC, cepe 
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pQ^d:jbK‘AppPi^nptum^^ 8-ymts: To ' 

■ relPm the ftr^s <if programmbig Be^ridOs in 

': ' [:Sincd ftihting ^0 'Mhirqppi^ in mrly 
l!;^J6rlawrena! You has, heen be^hig sh(4^ 

■ the Cpde^Urrior debitggfn^ arcbitectiire^jbr^ 

DSitan^s,} mducHngRbtd^otiy He^ 

J klqhgUfnfMac^^^ aisa 

ftK>rikngf<}rA0(eaW Tahgent, 


As you read this column, the finisliing touches are being 
applied, as QxleWarrior Pro 2 gets ready to ship, Hopuhilly^ 
you've all had a ehance to bang on die first Rhapsody pre-release 
and ytiu’rc chomping at the bit to get yt>ur apps ported using 
Latitude and the first native-yelltjw lx)x version of CodeWairion 
This month’s interview is with the CodeWarrior Rhapjiody team. 
It is the first half of a two parter. The second half will l>e featured 
in next niontli's issue, 

Oavei What’s the current state of Metrowerks’ Rliapsody 
development tools? 

Berardino Baratta: By the time you read this, 

C^)deWaiTior Professional Release 2 will have shipped. The 
Fro 2 release will show the fruit of our current labors (oh, the 
joys c^f printed publications and their built-in time delays). 

We plan on having a release of our C/C++ PowerPC compiler 
with support for generating mixed C/C++/Objeciive-C 
binaries for native Yellow Box, which builds on the first pre¬ 
release version of Objective-C support that we shipped on 
Pro 1. We will also tie shipping a pre-release version of both 
our IDE and Debugger hosted on Rliapsody as native Yellow 
Box applications. This port will be done using our 
Metrowerks Latitude porting library, which forces us to ^‘ear 
our own dogfood", so to speak. 

I'he new Apple OS architecture forced us to come up with a 
debug kernel solution that didn't involve MetroNub^ as 
MetroNub was designed strictly for Mac OS and wouldn’t port 
to Rhapsody, For iliat we ported a piece of technology that 
crame out of the ashes of the Taiigent project, 

WeVe also mtxlified our x86 code generator to emit Mach-O 
exet:uta!)lcs, so that when Apple releases tlieir version of 
Yellow Box for x86, CodeWarrior users can target liuilding 
binaries for that version without having to change toolsets. 

Dave: What’s the status of the Objeedve-C compiler? 
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Andreas Hommcl: The basic Oljjcaive-C support is 

pretty mucli complete. We actually shipj>ed a pre-release of 
our Objective-C (ronC-cnd on the CodeWarrior Pro 1 CD (in 
Pre-Release: 1.9bl MacOS plugins.sit). This compiler comes 
with a mini runiime that lets you use Ot>|ecUve-C under Mac 
OS. Objeaive-C is aaually a relative small extension to ANSI 
C (or C++) and a lot of the real advanced functionality, such 
as remote messaging, comes from NeXT’s foundaiion 
framework. As you've seen in recent issues of MacTech, the 
OpenStep environment gives you a way to start learning llie 
Objeaive-C syntax until Apple ships llie first developer's 
release of Rhapsody. 

Dave: Wliat about support for modem Objective-C syntax? 

Andreas Hommel: We still have to add support for the 

modem Objective-C syntax. The classic: Objeaive-C syntax is 
based on Siiialllaik and it looks a little weird to C/C++ or Java 
programmers. The modem syntax is much closer to C++ or 
Java. So, for example, instead of writing code like this; 

e implement a tioti HyCiaes : HSObject 
int tn; 

) 

' {void)setJ(int)1 

I 

; 

) 

(void)print 

printf (‘’m “ 1Cd\n"*iit); 

1 

$end 

int mainO 

( 

HyClass *my; 

iBy“tfMyClasB alloc 1 init j; 

[my set a23j: 
fmy prlnLl i 
[my dealloc]: 

return 0: 

I 

You will soon be a[>lc to write code like tills: 

^implementation MyClass t NSObject 

int m: 

I 

void set Cint i) 

I 

in“i; 

J 

void print(1 

r 

prlnif('m - %d\n".m); 

J 

Send 

int mainO 


KyClass *ny: 

my^tnev MyClass)->lnit0; 
my->set(123>; 
my->prijit(); 
delete my; 

return 0i 


The latter, modern form looks a lot more familiar to C++ 
progratnmers. We will suppon this as a real modern syntax 
specification falls into place, 

Dave: What changes were required in the code 
generators to support Rhapsody? 

Bob CampbeiL As far as ABI changes go, Mach for PowerPC 
changes some of the runtime mtxlel from the Mac OS ABI. 
While ihe usage of registers when calling funaions is almost 
exactly tlie same, the Mach model docs not have a 'TOC” 
pointer. This changes the way that global variables are 
addressed, a.s well as the way [hat routines in shared 
libraries arc called. 

There are a lot of reastjns for the changes to the ABI. 
Unfortunately, it would probably take an entire article just to 
explain the underlying logic tehind the current Mach-based 
ARl design. 1 or now, I think it would be useful to see an 
overview. If we get the chance, we'll explore these issues in 
more detail in a future column. 

Addressing glofxil variables, in Mac OS addressing an 
external global variable requires an indireciion via a TOC 
pointer, as follows: 

Iwz r4,x(RT0G) 
iwz r4,0(r4> 

In .Mach (using the static modeD^ this would l>e done by 
breaking the first instruction up into two. ITte first loads the 
high half of ilic address, which is then used as a l^ase register 
with the low half of the addrc'ss to load the aaual data: 

lia r4.HA(L_x$J!on_lazy_ptr) 

Iwz r4,L0{L_x$non lazy^pU ) (r4) 

Iwz r4,0(r4) 

Note "UA” is the high 16 bits of the address adjusted for the 
case where the low 16 [>iLs when treated as signed becomes 
a negative value. It is possible to use the HI function but in 
this cause it would require more instructioas: 

lis r4, HT (L_xStioa_lazy_pxr) 

□ri r4. r4,LO{L_x$non_la 2 y_ptr) 
twz r4.0tr4) 

Iwz r4,0{r4jl 
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Purify on Unix 
Bounds Checker on Windows 
Now, from the makers of QC, comes 




On Macintosh 


Find Bu^ Fast 

Spotlight 15 the fjT^r Automatic Memory Debugger for the 
M^cifuush* Instantly detect invalid memory accesses, bad 
Uxilbox parameters, leaks, stack overwrites, memory rcIcKa* 
tion problems, and nmeh more* 

Spotlight uses yoor XSYM file to automatically patch your 
application — no need to change ytuir source code* No need 
10 recompile. No learning curve wliatsoever. 

The interlace gives you instant fcixfhack when an error is 
detected. You can ignore the crn>r, ignore all future occurrences 
of the error, or log the error to a text file for later analysis. 

Fine Grained Memory Protection 

Spotlight identifies reads and writes outside of the applica¬ 
tion and sysretu heap. But it does not stop there. Spotlight’s 
Object Ctxle Replacement iasmimentat ion inspects each read 
and write instruction in your code, detecting faulty memory 
reads and writes diar occur between blocks, in released hkxks, 
across nnikiple blocks, and in ROM. 

Tl’iis technology works on any heap object you con allo¬ 
cate: Mac heap tjhjecis, C Yiialloc’ heap objects, even C+ + 
tihjeers created with new. 

Spotlight stops your applicaticin whenever a faulty memory 
access is about to ticcur and displays the exact source ctide 
line where it will happen. The calling stack is shown along 
with a display of all variables, A meinory viewer shows the 
erroneous memory address and contents. 

Toolbox Validatioti 

Spt>tlight checks pammereis to over 400 toolbox API calls, 
automatically validating handles, memory bkxiks, return vah 
lies* and so on. Specific cliecks catch subtle errors such as draw¬ 
ing into an unlocked GWi^rld, passing an invalid window 


pointer, passing an address within an unlocked handle to a 
routine that may move memory, and too many more to list. 

Leak Detection 

No more struggling with MacsBug. On program exit Spot¬ 
light provides a clear listing of all leaked memory showing a 
hill stack trace from where the memory was allocated. Ir^stantly 
discover all leaked Mac OS objects, malloc’d objects, 
objects, and resources. 

Limitations 

Spotlight requires an XSYM file to function. MPW and 
G)deWarrior users can generate these directly. Symantec us¬ 
ers must use TootServer to link with an XSYM capable linker. 
Spotlight requires a PowerPC processor, 

Sptiflig)>i works on the object ccxie. Ntv stmree code is 
quired: just the thing for tesring purchased third party librarii^s. 

Availability and Pricing 

Pricing for Spotlight DR I is $ 199 US ( plus $ 5 shipping and 
handling within rhe coniinenml US, $15 for intomarional 
orders). Tit is includes a free upgrade to the GM version and 
access to ftp interim upgrades leatling up to GM. QC users can 
cross-grade to Spotlight for only $149. 

All Onyx prtxlucts carry a 30 day nti ciuestifais asked money 
back guarantee. 

Onyx Technoh^gy, Inc, 

7811 Z7th Avenue West 
Braden Lon* Rorida 34209 

sa iesl®ony X' tech .com www. onyx - tech .com 

941 795-7801 941 795-5901 (fhx) 



SfiiMliRlii flnrt QC nre rnxkmnfb otCkiyx Iik, All rwlwr rrMbmiifb are jwwfeiry rlwu refficiiilvc tiwiwis. 










When we are using the dynamic model we need to use a base 
register to insure position independanc code so it becomes: 

: set up PIC base reglatei: 

ELflr rO ; save the return address 

bl L_pic_base : put pc of ne^t Instruction in Ir 
L_plCubase: 

mflr tl r setup r3 as a base register 

addis t4,r3.HA(L_x$non_laKy_ptr■ L_plc„base) 
lyz r4*LOtL_3E$nori_lazy_ptr-l^pic_base) (r4j 
luz r4.D(r4) 

iQtlr rO ; restore return address 

blr 


Another example is of differences in calling external 
functions. In the Mac OS cas€» there may need to be a reload 
of the TOC pointer so it inserts a nop which the linker may 
fill with an instruction. In the Mach case, the reload of the 
TOC is not needed. 


extern void xtvoid): 

void y(void) 

I 

3t0 T 


mflr tO 
st¥ r0,0(rl) 
stvu rl,-64{rl) 
bl 

nop : slot for restoring the TOC pointer if needed 

Ivz r0,72(rl) 

addi rl.rK64 

mtlr rO 

hit 

becomes: 


Dave: Whaf s the linker strategy for Mach-0? 

Berardino Baratta: For this part of the equation, we 

decided early on, after discussions with core Apple/NeXT 
engineers, that NeXT had developed some very good 
linker technology, and it made the most sense to license 
that technology so we could convert that command line 
linker into a Code Warrior plugin for use under our IDE. 
This allows us to concentrate our resources on the rest of 
our tools and not in trying to replicate the excellent linker 
optimisations that the NeXT linker implements. This helps 
reduce the method call overhead penalty that the 
ObjectiveC runtime imposes. 

Dave: What can you tell me about porting the IDE to 
Rhapsody? 

BerarcUno Baratta: Technically, we don't have to do 

anything to port our IDE to Rhap>sody as it will run just fine 
inside of the Blue Box (Apple's siilution that allow users to 
am their existing application inside of Rliapsody). Of course, 
that would be too easy. So, as I said before, we're using 
Liiitude to solve tliis part of the equation. This solution 
involved a two step process. 

First, we ported our IDE to run under Latitude hosted on 
SunOS, as at the time Latitude for Rhapst^dy was still under 
development This cleaned up any issues in the IDE that were 
not supported under Latitude, and validated the core of 
Latitude with another large sourceliase. 


mflr rO 
Etw r0,0(rl) 
styn rt,'64(rt) 
bl L_K$stub 
Ivz r0.72(rl) 
add! rl.rl*e4 
mtlr rO 
blr 


Next, we rebuilt tlie IDE under latitude for Rhapsody, giving 
David Hempling and the oilier Latitude engineers a large 
sourcebasc with which to validate their port of Latitude for 
Rhapsody, If all went well, tlien you should be seeing the results 
of this work on Pro 2, as a pre-rcIeasc veision of the Metrowerks 
IDE running native on Rhapsody in die Yellow Box. 


Dave; What about object formats? 

Bob Campbell; 'ITie object format defined by Apple for 
Rhapstxly is Mach-O. It is a very different from the object 
format that Metrowerk.s uses for Mac OS, 

One big difference is that in our Mac OS ol^t format we let our 
linker resolve things which the Mach-O objea formal leriuires be 
resolved at compile time. For example, in our current object files 
we ,stait the address for each function at Kero and let the linker 
resolve the addresses. For Mach-O we must assign each function 
aixl variable a unique address before the object file is written, 

1 would like to point out that these are tlie ABls and Object 
Formats that are being used for the initial release of Rhapsody. 
Once the initial version is out the door we will start looking 
for ways to improve the performance of the dynamic model. 


In ilic future, weYe going to use the native h<x>ks in Latitude 
to add in Yellow Box specific funaionality that will make sure 
that the IDE is, from the user's standpoint, a fully native 
Yellow Box application, 

Dave: Will there be any integratton between 
C^eWairiof and InterfaceBuilder? 

Rerardino Baratta; Yes, weVe working together with 

Apple to fully support InterfaceBuilder (TR), but this work is not 
scheduled to begin until after our IDE is up and stable under 
Rhapsody, Our gtral us to replace Projecftiuilder, in order to 
provide seamless support between TB and the Metrowerks IDE. 

Next month, well finish up this interview, starting with 

I.awrence You's discussion of yellow box debugging plans, H 
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Start Designing in Minutes With 

l|uiekCRC 


Identify Objects 

Discover ihc objecis for your desigri 
using CRC cards (class, responsibility 
and collaboraiions). Create a card for 
each object that idenlifies its relation¬ 
ships, attributes and respnnsi hi lilies. 


Report 
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Simulate Scenarios 
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Create scenarios that 
step through the 
mechanisms in your 
design by using the 
responsibilities of 
objecis or by calling 
other scenarios. 

Now simulate your 
design to make sure 
it works. 


I iMitIfttt 


ijaisti 


I Often mk dH'Ba>iat h 


*C 14 Hr 6 ibM 

w*H)i 

KeaCiflnsIbi I llur nrai 
. I 

Attrlbutn niirdtri 

rH"V^lf)ltnn' iikdtll 
mtrkfcuu iHck^t 




■van • 4toe«nl 


[■«»>> LMij n~i rn rsn iti-tiwi 


Use Your Design 

List your design to lexl and 
use it as a code specifica¬ 
tion or export it to 
MacA&D or WinA&D for 
detailed design and code 
generation. Use Mac Translator or 
WinTranslator to auiomaucally generate 
QuickCRC cards from existing code. 
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Trun 

QuickCRC 


Mac in tush ur Win dims 95/NT $395 

|>r iiKPi i; lli1i>nniiiU(in; 

hHp://www.excelsoftware*ccim 


Automate The Process 

QuickCRC has the features you expect in a design tool, like 
the ability to maintain relationships between cards and 
scenarios as fluid design changes take place. For complex 
projects, objects can be grouped functionally into separate 
diagrams. QuickCRC can visually arrange card and scenario 
objects for you to highlight relationships. Design models can 
be verified to locate errors* Use QuickCRC to collect your 
thoughts and put design ideas on paper in minutes. 


Excel Software 

Computer Aided Software Engineering ■* 

515 - 752 - 5.^59 

Fax:515-752-2435 
info @ excelsoflware .com 


MacAnalysC MacA&D, MacTninslutcr, WinA&D. WinTranslalor and 
QuickCRC are tnidcmark^ i>f Excel Software, © 1997. All rights reserved. 
Other bmnii and product names are trademarks of thei r icspcclive holder.s. 























































































































































































PROGRAMMIMC 

TECHNIQUES 


Lawrence D’Oliveira 


Routines as Values 


The High-Level 
Programmer’s Guide to 
Generating Code at 
Run-Time 


iNTRODUCnON 

This article is about passing around 
routines (procedures and functions) as 
values. That is, you take the address of a 
routine, pass it to another routine as an 
argument, maylx: even store it in a data 
structure for kter use. Ultimately the whole 
pcjint with a routine is that you make a call 
to it; but many interesting things can 
happen on the way there. 

Tltcre are many useful programming 
techniques to do with routines as valuc-s. in 
my view, these tcchnicjues cieserve to be 
more widely known than tliey arc, because 
they can contribute so much to the 
principles of remahle code and 
informaliotr hiding that gocxl prognimmers 
value. This article will give you an 
introduaion lo some of these techniques. 

To make sense of this article, it helps 
to have some understanding of 68K 
assembly language and how it interfaces to 
the Mac OS, The definitive reference to 
68K machine language is the 68000 Family 
Programmer's Reference, available from 
Motorola’s Web site as an AcTobat PDF file 


at <http://www.mot,com/hpescl/aesop/68k/68kprm.pdf>. Links to related 
documents can be found at <tittp://vww,motxom/SPS/'' 
HPESD/docs/pubs/index.htinl>. For a description of 68K calling 
conventions on the Mac OS, see the 'I'rap Manager chapter of 
Inside Macintosh: Operating System Utilities, available on-line at 
<ftp://ftpdev,inkapplexomy/DevelopeLServices/Technical_Documentalion/l 
nside_Macintosh/Operating„Sy5tem_Utilities/>, (Another aseful and 
brief article introducing the basics of 68K ASM is “The SecreLs of 
the Machine" l^y Malcolm Teas in MacTcch 9,5, It is available 
from <http://web.xplainxom/mactechxom/Artides/VoL09/09.05/Read' 
Assembly/text,html> — ed]. 

Language Notes 

Most of the code examples in this article are writien in 
Modul;t-2. Specifically, they were written for the (now-Hdefunct) 
Meirtiwerks Modula-2 compiler that ams under Apple's MFW 
(Macintosh Programmer’s Workshop). I use this combination 
because it’s been the best language and development 
enviromnent for the kinds of programs I write. 1 recently got hold 
of die pi Modula-2 compiler from Germany, but have yet to start 
using duL in earnest. 

At the end of the article, I will discuss the applicability of 
these techniques to other languages: everylxxly’s favorite, C, and 
everybody else’s favorite, Pascal, 

in the meantime, Tli explain a few tilings for those who 
migln ixr unfamiliar with M<xlula-2, but are familiar widi Pascal, 
And if youVe not familiar with Pascal, then youTe not a real 
programmer.., 

Modul3-2 has a lot in commtm with Pascal, and most of the 
following code should be comprehensible to Pascal 
programmers. It ha,s the same signed integer types as Pascal 
(INTEGER for l6-bit integers and LONGINT for 32-biL ones), btit 
it also 1ms unsigned integer types- CARDINAL for l6-bit ones and 
LONGCARO for 32-htt ones. Pointer types are defined using the 
syntax "POINTER TO T instead of Pascal’s And there is a 


Lawrence D’Oliveiro has been doing IkmIi high-level and low-level programming on a variety of different platforms over the 
last eighteen years. When he’s not playing with hi,s technotoys, or worrying about which cool technology Apple is going to 
abandon next, he likes cycling and walking around ihe nearby Waikato River, 
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general untyped pointer type, ADDRESS, which is compatible 
with any pointer type, 'llie Pascal compilers on the Mac don’t 
seem to have any equivalent to tliis; it is like the ^votd type in 
C. Ihe built-in ADR function returns the address of something; it 
is ecjuivalent to tile operator in Pascal or operator in C. 
Like the Pascal version (but unlike the C one), it always returns 
an untyped pointer value, that is, its return type is ADDRESS, 

If you want to do unsafe type conversions* there are two 
ways. One is the traditional record-variant trick from Pascal (or 
unions in C), The other Is tlie use of the CAST function. You will 
see both in usq later. Unlike Pascal or C, you can't just use a type 
name as a function to do a cast; this makes unsafe conversions a 
little easier to find in the code! 

The big difference from Pascal, for the purpcjses of this 
article, Ls that Modula-2 allows you to declare routine types. That 
Ls, you can write pieces of code like tliis: 

TYPE 

MyProcType - 
FROCEDURE 
( 

INTEGER 

VAR 

ProeVar i HyProcTypei 

K : INTEGER: 

PROCEDURE NyProc 

( 

Arg : INTEGER 

BEGIN 

FpND HyProc j 

BEGIN 0 Jnain program *> 

HyProeCK): C invokes MyPrxx: ^ 

ProcVac r” HyProc; 

ProeVar (K): C also invokes MyPnx: *> 

in Pascal, you can take the address of the routine: 

Var 

PtoeVar : Ptr: 

Procadwre MyProc 

( 

Atg : Integer 

Begin 

End iNyProc) ; 

Begin 

t main ptogrem ] 

MyProc(K): 

ProeVax := ^MyProc: 

But there Ls no way to define a type like MyProcType in the 
Moduia-2 version, and the language provides no standard 
mechanism for calling the routine once you get its addre.ss tn 
ProeVar. Of course, you can get around this, in a type-unsafe 
way, witli appropriate use of inline macliine code. 

C programmers will already l>c familiar with all this, since C 
has similar sorts of facilities to Modula-2 in this regard, allieit with 
slightly less elegant syntax: 


typedef void (*MyPrt)cTypc) (short): 

MyProcType ProcVar; 
short K: 

void My P roc 
( 

abort Arg 
) 

I 

i ’ /^MyPnjc*/ 

void main 

t 

void 

) 

( 

HyProc (K) i r invokes MyPruc 7 
ProcVac = iHyProc: 

(‘ProeVar) (E): t a*so invtjkcs Myftoc 7 

1 did a quick search for Modula-2-relaled information on the Web, 
and was amazed at how much 1 found. Here are a few URLs to get you 
started: <http://wwwJnfm.ulst.ac.uk/-george/mp/pract/modula.htmi>, 
<http://www.ee.n€wcast)e.edu.au/users/staff/peter/m2/Modufa2.html>, 
<htlp://wwwJse.fhg.de/person3Lhomej>ages/hubertus/t0ae/iabcont.html>. 
Anyway, enough with the preliminaries, on with tlic show,,* 

Action Roltines 

TTiere is fretiuently a need to traverse a complex data 
strucaire, I(K>king for elements that matcli a particular criterion, 
and doing some processing on them. For example, consider the 
System 7 process list: ytm might want to scan it to see if a 
particuiar pnjgram is running. Or you might want to total up 
infe^rmation about all processes, or display them in a list for the 
user's information. In all these applications, there is a certam 
recurring pattern to tlie code: 

• Declam a variable named, say, CunentProcess, of type 
ProcessSerialNumber. Initialize it to kNoProcess. 

• Call CietNextPnocess, passing it CurrentPnK:css. If you get an 
error, exit the loop. 

• Perform whatever pnx'essing is appropriate on the pnx'css 
with the serial number in CurrentPrDces.s. Then mpeat from 
the previous step. 

The code in the first two steps would be the same in every 
case. Ideally, you should be able to write it just once, and reuse 
this code everywhere you need to. How can you do this? 

The answer is to write a generic process-traversal rt>uline, 
which calls an action routine that you specify for each process, 
in Modula-2, you could define the type of the action routine as 
follow.s: 

TYPE 

ProcessActions 

PROCEDURE 

( 

VAR (ThisProccss O PcocessSerialNiimber, 

VAR (^Proccsslnfo ProcessInfoRec * 

VAR rKjeepGoing :•) BOOLEAN. 

CAcUotiAi;g ADDRESS 
); 

Tlie first two aiguments pass all the information about the 
process that the Process Manager prt>vides. The KeepGoing 
argument may be set to false by die aaion routine to .stop die 
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Lraversal. This is useful if, for example, youTe searching for a 
particular process, and you don't need to search further once 
youVe found it. The last argumeol allows the passing of 
additional data whose meaning is up to the caller; well see one 
interesting use for this later. 

And here's the generic process-traversal routine: 

PROCEDURE TcaversePr^jcesses 
( 

Action r ProcessActions: 

ActionArg : ADDRESS 


VAR 

ThisProcess : ProcessSerialNumber; 

Processlnfg i FrocessInfoRec; 

ProcessName : St £-255; 

AppSpec : PSEpec; 

KeepGoing r BOOLEAN; 

Err : OSErr; 

BEGDJ 

TbifiProcess^highLongOfPSN 0; 

ThiBProcess^lowLongOfPSN kNoFrocess; 

ProcessInfo*pracesaInfoLfiOgth := SIZE(ProcessInfoRec); 
Process Info »processNaine ADR(ProcessMaiie); 
ProcessIafo-processAppSpec := ADR(AppSpec); 

KecpGoing := TRUE; C Initially *) 

LOOP 

Err !“ GetNextProcess(ThisProcefie): 

IF Err <> noErr THEN 
EXIT 

END CTF*); 

Err GetProceesInfocination tThisProcess » Processinfo); 
IE Err ^ noErr THEN 
Action 
( 

ThlsProcesSt 
ProcessInfOi 
KeepGolng* 

ActlonArg 

IF NOT KeepGolng THEN 
EXIT 
END cm 
END on 
END ru)op> 

END TraverseProcesses; 


A sorting example 

Another use for action routines is to isolate assumptions 
about data struaures. Consider a common operation: sorting. 
YouVe probably got a collection of favorite sorting routines that 
you like to use. What sorts of assumptions do they make about 
the data being sorted? Does it have to be in an array? Can it be 
in a disk file? Do the sort keys have to reside together with the 
rest of the data? Why make any assumptions at all? 

Many sorting routines cun function by making only two 
kinds of accesses to the data: they need to be able to compare 
the keys of two records, and they need to be able to swap the 
ptxsitions of two records to get them into die right order. Let's 
define interfaces for aaion routines to perform these operations; 
TYPE 

ComesBeforeProc - 

PROCEDURE 

t 

CRtR:’) LONGCARD* 

(^•ond:*) LOKGCARD* 

CAfR:*) ADDRESS 
) : BOOLEAN: 


Swap?roc “ 

PROCEDURE 

{ 

CFir^;*) LONGCARD, 
rSccond;*) LONGCARD, 

CAib:0 address 
): 


The one assumption I will make is that records are 
identifiable by index numbers starting from 1, A 
Comes Before P roc returns true if the record with index First is 
supposed to come Ix^fore the one with index Second (that is, 
theyTe already in the right order); it returns false otherwise. A 
SwapPren: is called to swap two out-of-order elements: after it 
executes, the record which had index First should now have 
index Second, and vice versa. 

As widi the process-traversal example, each action routine 
takes an additional argument which may lie used to pass 
additional caller-specified infiirmation, 

Here's a sorting routine that uses die above aaion routines 
to implement a simple Shellsort: 

PROCEDURE Sort 

c 

HrElenente : LONGCARD; 

CdmesBefote ; ComesBeforeProc: 

ComesBeforeArg : ADDRESS: 

Swap : Swap?roc; 

SwapArg : ADDRESS 
}; 

VAR 

i, jp k, 1, m : LONGCARD; 

BEGIN 

i := 1; 

WHILE i < NrEleinents DO 

i i + 1 

END {-WHUE*); 

m (1 ' 1] DIV 2: 

IF {m = 05 AND {NrEleaents > 1) THEN 
(* do at least one pass when sorting 2 detJK'nts *> 

HI ;= 1 

END cm-. 

WHILE HI > 0 DO 
k NrElaments 

FOR j 1 TO k DO 

i := j: 

LOOP 

1 := i + Hj; 

IF CoaiesBeforeCip 1, ComesiBeforeArg) 

THEN 

EXIT 

END riP): 

SwapUr 1, SwapArg); 

IF 1 <” Ki THEN 
EXIT 

END (*IP)r 
1 1 - ID 

END {‘LOOP*) 

END CFOR'); 
m m DIV 2 
END CWmiiF) 

END Sort; 


Of course, you cxnild repJace the Ixxly of this routine with 
jast about any sorting algorithm you like, and keep the same 
interface. Here's a very simple, almost trivial example use of this 
routine to sort an array of iiuegers. First we declare a data array, 
and comparison and .swap routines for the sort: 
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TYPE 

ElementType = INTECEEi 
VAR 

MyData : POINTER TO 

POlirrER TO ARRAY [I . . lOOOOj OF ElemetitType: 
KyMrElement!! : CARDINAL: 

PROCEDURE MyComesBeforj; 

C 

First, Second : LONCCMD; 

Unused i ADDRESS 
) ; BOOLEAN: 

BEGIN 

RETURN 

MyDatfl''* [First] 

MyDflts^^ [Second] 

END MyComesBefore: 

PROCEDURE HySwap 

First* Second : LONGCARD: 

Unused : ADDRESS 
); 


VAR 

Temp : ElementType; 

BEGIN 

Tamp MyData'^''[First] : 
MyBata'^nFirstJ HyDa Second ]; 

My Data'''^[Second] Temp 
END MySwap: 


And here's the caii that does tJie actual sort: 
Sort 

f 

(‘NrFJcmcnts :=*) MyNrEl etnents * 

(TomcsBcft)rc :=*) MyC omesBe fore, 
(*ComcsBcfdrcAjB :=•) NIL, 

(•S\vap:=") MySwap, 
rSwapAi^:-*) NIL 
) 


This example makes no use of the extra arguments that can 
l>e passed to the comparison and swap routines, later we will 
see an iniere,sting use for these extra argumenLs. 

ClXWURES 

In langitages like POP-ll and LISF, which are primarily used 
for Artificial Intelligence work, you c:an have a lot of fun with 
functions. You can even create new functions at run-time! 

But why should AI researchers have all the fun? Can’t you 
create funt:Lj<ias at run-time in a common language like Pascal, 
Modula-2 or C? Certainly you can! 

The bad news is: die techniques for doing this rely on 
particular features of the compiler and machine. It takes some 
work 10 gel them right the first time. And certain compiler 
optimizations can signficani problems. 

The good news is: once you get it right, iTs a lot easier to 
do again. And these become very useful techniques, that you 
find yourself using over and over! 

Technic^ally, a Curried funetton (it’s named after a jierson, 
not a dish) is created when you take a function widi many 
aiguments, and ‘'bind” some of tlicm to particular value; the tesuk 
is a function of fewer arguments. A closure, on the other hand, is 
created when you bind a funaion to iLs parent environment, to 
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create a new function which autoimtically sets up the correct 
environment for the original function when it's called. 

To illustrate closures and environments, consider a conunon 
problem on the Mac: accessing A5 gld^als from an intemipt routine. 

In nic^t Mac languages, when you declare a bunch of global 
variables, the compiler alkxrates them in a block of memory 
accessed relative to register A5. A5 is also used to access the 
application’s segment table, as weO as QuickDraw’s global storage. 
Thus, A5 is a very important register, and your application code is 
liai^le ic.) behave very strangely if it’s called with an incorrect value 
in A5, and it tries to access any global data. 

Instead of putting special code to deal with diis into all of 
your interrupt routines, the principle of reusable code dictates 
that you should write this code just once, and use it over and 
over. Thar is, you should write a general library routine which, 
given an interrupi routine, creaie.s a ‘"wrapper" routine for it that 
passes die correct A5 value. ITere’s an example of what 1 mean- 

TYPE 

BqundInterruptFroc “ AKRAY [1 .. 9] OF CARDXKAL: 


A BoundlntairuptProc is an array which wiQ hold die die code 
for the wrapper routine. The wrapper ccKle itself is filled in l>y 
BindInterruptProc, which is defined as follows: 

PROCEDURE CurrentASC) : LOHGCARD: 

C returns the curtciU value of the global base n^ister.*) 


CODE 

02E8Dfl: 


Cmovc.la5,(sp)^ 


PROCEDURE B1ndInt e rrup tP r oc 

TheProc : ADDRESS: 

VAR Result I BoundlnterruptProc 

C cotmmets the wtapfser amund the specified proccdutt:.') 


VAR 

TuoWords : 

C used to access a kmgwotd as two words ■) 
RECORD 

CASE : BOOLEAN OF 
I FALSE: 

LongValue : LONGCARD 
I TRUE: 

HlghWord, I.owUord : CARDINAL 
END CCASEO 
END CRECORD*); 


BEGIN 

Result ID 02 FODH: Cmove.l» 5 .-(sp) *) 

C save prcvious ') 

Result [2] 02A7CH; C niovc.l 

TwoWords.LongVflltje CurreutA^t): 

C n for picvknis instr *) 

Result[3] TwoWords.HighVord: 

Result [41 TwoWords.LowWord: 

Result [3] 04EB9H: Cprp') 

TwoWords. LongValue : = TheProc : C p for previous inslr *) 
Result [6j TwoUords.HighWord: 

Result[71 :* TwoWorde.LowWordj 

Result [S] 02A5FR: C muvc.I (SpH, 0 

(• rtstorc pn^omA> 

Result [9] 04E75a: (* 

FlusbCaches 

END BindInterruptProc: 


St) instead of passing the address of your actual intemipt 
routine to die system, you pass the address of tlte* appropriately- 
filled-in BoundlnterruptProc structure, for example: 

VAR 

Parans : HFaramBlockRec: 

BoundCoiapletinn : BoundlnterriiptPiroc; 


BiridInterruptProc(ADR(HyGQapletiqn). BoundCoiapletioD): 
ParaifiS*ioCoaipletlon ADR{BoundCoBplGtion) t 

Err PBReadAeyTlc(ADR{Parains)): 


and in your interrupt routine you have full access to all your 
A5 globals! 

Note that FlushCaches call at the end of the definition of 
BindlntarruptProc. This Is necessary because of a piece of brain 
damage in Motorola’s 68030 and 680^0 processors. Ihe problem 
is tliat, on these processors, memory references are divided into 
two kinds, data and code, and there is a separate CPU cache for 
each, with no attempt to maintain consistency between them. 
Thus, if a given memory location ends up in both caches (as 
could happen when you generate code at mn-lime, as 
BindInterruptProc does), it is possible for it to be modified from 
the data t:ache, without the instruction cache picking this up! 
Then, wlien you later try to execute the iastruction at that 
memory location, you get the wrong value, and crash... 

Here’s how FlushCaches is defined. This definition is safe 
to use on all members of the 68000 CPU family, with system 
version 6,0 and later. U even works on Power Macs, where it 
flu.shes the cache of compiled code on models with the DR 
(“dynamic recompilation”) emulator, and doe.s nothing on 
older Power Macs. 

PROCEDURE HVPrivProsentO : BOOLEAN: 

C has Ibis system gm the HWPriv trap, *> 

CONST 

Unluplejnentedtrap * 009FH: 

ICWPrivTrap - OAl^BH: 

BEGIN 

RETURN 

GetOSTrapAddress(dWPrivTrap) 

<> 

tOSTrapAdd teas (UniiDplamentadTrap) 

END HVPrlvPrcsent: 

PROCEDURE FlushlnatruetlonCa che; 
r aciLially Hushes both irmnictkin ind data caches, “) 

CODE 

07001H. Cm<ivct|.l#l,d0*) 

0A198H: C„HWIMv*) 

PROCEDURE FlushCaches: 

C Huishcs instmciion and data tadics, If presem. *) 

BEGIN 

IF HWPrivPresent 0 THEN 
FlushlnstructinnCache 
END CIF^ 

END FlushCaches: 
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Binding Actual Argumlni's 

Often, in a routine of yours that is called by the system, you 
don't need access to all your A> globals, but you do need access 
to a particular bltKtk of data. Depending on die situation, the 
.system may provide all kinds of different ways of passing the 
address of this block as an additional atgumt^nt to your royiine 
“ or it might not provide any way at all. 

For example, die action routine you pass to the Control 
Manager’s TrackControl routine gets the control handle as an 
argument, so you could use the refCon field in die control record 
to pass information to it. That is, unless the part of the control 
youTe tracking is an indicator (such as a scroll liar thuml)), in 
which case you don’i get any argumenLs at ail. Of course, if your 
t:ode is part of die currendy-running application, you could 
probalily get away with using A5 globais in this ca.se. 

^ITiere are other, equally complicated situations. Time 
Manager tasks didn’t use to get any aiguments, until System 6.0.3, 
when dicy started getting the address of the TMInfo record in 
register Al. Memory Manager GrowZt>nePixx:s don’t get any 
aigumenLs, and you am'i guarantee that some pan of the system 
(or some weird INIT) won’t try to allocate some memory in your 
heap while the A5 value is set to something nonsensical. 

Now, what do you tliink; would you prefer to resort to a 
range of different fiddly techniques to deal with each of these 
situations, or would you rather stick with one general, unifonn 
technk|ue that can liandle dicni all? 

I know which I prefer, I would Curry my routine by binding 
it to the address of my data, using the following Bind routine; 

TYPE 

(* siruciurc for liulding Curried routine *> 

BoundProc - ARMY li ., 8] OF CARDINAL: 

FROCEDIIRE Bird 
( 

TheProc ; ADDRESS; 

ToArg : ADDRESS; 

VAK Result ; BouudProc 
); 

C treateji A new procedurc whkrh calls ITicPtoe 
with ToAiu as m ctira atEumeBL *) 

VAR 

TwoWords : 

C used to access a longword as two words ^ 

RECORD 

CASE : BOOLEAN OF 
I FALSE: 

LongValue : LONGCARD 
I TRUE: 

HighWord* LowWord ; CARDINAL 
END ('CASE*) 

END (’RECORD'); 

BEGIN 

ResultllJ := 02F17Ji; <* move.l (sp),-(sp) *) ) 

Result I2j 02F7CD: Cmovei#iii,ii(sp) ') 

IVoUoirds . LongValue ToArg; (* m for above move *) 

Result[3] TwoWorda.HighWord; 

Result pi] TwoWorda.LowWoed; 

Result [5] (* n for above move *} 

Result [6] 0AEF9R: C W n *) 

TtfoWotda, LongValue ThoProc; C ^ for i*«P T 
Result[7] := TwoWords.HigbWord; 

ResultL8J := TvfoWorda.LowWord; 

FlushCacbes 
END Bind: 
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Note that you can use Bind on any pitx^edure or funaion of 
just about any number of ailments, and (if a function) returning 
a result of any type. The only restrictions are that it must follow 
Pascal calling conventions (as Meirowerks Moduk-2 does), the 
argument you are binding must be the last one in the aigumenl 
list, and it must he 32 l>iLs in size (such as an address)* 

Converting Calling Conventions 
Another important use for run-time closures is where the 
system invokes some code, that you supply, in a nonstandard 
way. One case chat has bitten many Macintosh programmers trver 
the years is the infamous TextEdit clikLoop callback. 

If you specify a clikLoop routine in your TextEdit record, 
TECIick will call it repeatedly as long as the mouse remains 
down. One use for this callback is to implement autoscroUing; 
TextEdit's default clikLoop action, like the nest of TextEdit, 
doesn’t know anything about scrollbars, so you have to provide 
your own code lo keep these in sync* 

The clikLoop routine is invoked in a .slightly odd way; it 
must preserve register D2 (normally on the Mac, any n>utine you 
call is allowed to trash AO, Al, DO, D1 and D2), and it must 
return a boolean result in the bottom byte of DO. If this value is 
ever false, then TECIick returns immediately, as though the 
mouse has been released* 

The trap lies in an intxaious-seeming library routine, that 
Apple provides, called TESetCIIckLoop. It looks very tempting to 
use, as it allows you to pass a clikLoop callback that conforms to 
straight Pascal calling conventions. Of course, it uses its own glue 
code internally to call your routine and convert appropriately 
between calling conventions* 

The problem lies in how this glue code finds your routine: 
the address of your routine is .stored in a global variable! What 
this means is, if you have two separate TextEdit records in 
existence at once, and you try to specify a separate clikLoop 
routine for each one, then the last one you specify gets called for 
both, since there is only room to remeralxrr a single one! 

The cornea solution is to create the glue code on the fly. 
Here’s a routine that does this: 

TYPE 

CllkLoopProc “ 

(* has anc more than TextEdit .ClikLoopProc *) 

PROCEDURE 

( 

CArg ;') ADDRESS 
) ; BOOLEAN; 

BoundClikLoopProc = ARRAY [1 .* 12] OF CARDINAL; 


j FALSE' 

LongVaiue : LONGCARD 
I TRUE: 

HighWord* LowWord : CARDINAL 
END CCASE*) 

END CSECORm: 


BEGIN 

Result [l] 

Result [2] 
Result[3] 


;= 02FOZH: 

04227H: 

02F3CH; 


TwaWords.LongValue 
Result[4] Two^ffords 
Result [5] TwoWords, 
Result[5] ;= 04EB9H; 
TwoWords.LongVelue ;= 
Result[7J 1 = TwoWords, 
Result[8] TwoWords 


ToArg; 
HighWord 
LowWotd f 


Cmow:! cI2,<sp)*) 

C save vulnerable reghoer") 
C<ir.hi$py} 

<* movri *n, <sp) *) 

C insert addltk>n 2 U arg *) 


Result[9] 
Result[ID] 
Result [U] 


- 07a00H! 
OlOlFH; 
0241FH; 


Result[12] ;= 4E75H: 
FlushCaches 
END BindClikLoopFroc; 


C n for above *> 
r ditto *) 

Cjsrl') 

CAST (LONGCARD, TboProe): 

Hi ghWord; {* high word of I *) 

L owWo rd: C low word of 1 •) 

Cmoveq,l# 0 ,d 0 *> 

C mowb (spHtdO*) 

C move.l (spH, d2 *) 

C ftstoie saved register *) 
Cm-) 


Note how, while I'm at it, I cleverly change the type of the 
ClikLoopProc that you must pass, to include an extra argument. 
This allows you to pass extra information to your ClikLoopProc 
when it is called, for whatever purpose you want. 

Up-Level References 

In Pascal and Modula-2, you can declare one routine local 
to another. In this case, the environment of the inner routine 
includes everything declared locally to the outer routine. In 
particular, it is possible for the inner routine to access variables 
declared local to the outer routine. 

How is this done? 1 know of two different techniques that 
compilers may use* One involves the use of a global display 
array of pointers to stack frames, indexed by the source nesting 
level of the routine. The other way is to pass a staiic link when 
calling a nested KMtine — this b just a pointer to the enclosing 
routine’s stack frame, 

On the Mac, one of these techniques is the right way, and 
the other is the wrong way. The display array is the wrong way, 
because it requires global data that Isn’t always available. The 
static link method is the right way. Thankfully, die Mac compilers 
I'm aware of all do it the right way* 

To illustrate how a .static link works, have a look at the 
fallowing piece of source: 

PROCEDURE Outer; 


PROCEDURE BltidCllkLoopProc 
( 

theProc ; ClikLoopProc r 
ToArg ; ADDRESS: 

VAR Result ; BotuidClikLoopProc 
): 

C bimb ThcRnn: to tbc .specified to citato 

a dusuic that can be invoked hyTouFdh as a 
ClikLoop procedure. *> 

VAR 

TwoWords : 

(* used to access a longword as two words *) 
RECORD 

CASE ; BOOLEAN OF 


VAR 

OuterVar ; CARDINAL: 

PROCEDURE Inner 
( 

NewValue : CARDINAL 
): 


BEGIN 

OuterVar NewValue 
END Inner: 

BEGIN coma*} 

OuterVar 1: 

Inner(2) 

END Outer; 
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Here's the code that the Metrowerks compiler generates for 
for procedure Outer: 

LINK A6.#$FFFE 

MOVE.W #S0001,-$<)Oa2(A6j ; OuterVar := 1 

MDVE.W j$0002,-{A7) : arg for call to Inner 

FEA (A6) 

JSR Inner 

UNLK A6 

RTS 


Note that the variable OuterVar is at offset -2 within Outer's 
sta<'k frame. Also note that when it calls Inner, it doesn't just pass 
the cardinal value 2 For the argument NewVatue; it pushes an 
additional longwortl, whir:h is the value of its A6 (stack frame) 
register To sec the Luse of this, here’s die code for Inner: 


LINK 

A6.#$0000 


HOVEA.L 

$0008(A6).A4 ; Outer's 

A6 to access OuterVar 

HOVE.W 

$000C{A6). $0002(A'l} ; 

OuterVar NewValuc 

UNLR 

A6 


HOVEA.L 

(A7)+.A0 


ADDQ.L 

#S6.A7 


JNP 

(AO) 



Notice how' Inner gets to OuterVar i>y using the stack frame 
pointer chat was passed to it by Outer. If Outer was itself declared 
local to another niutinc, it is similarly possible for Inner to access 
the local variables in that stack Frame by following the frame 
pointer value passed to Outer by its parent, 

'fo see the rt‘levance of this, here's an example use of die 
Traverse Processes routine I gave up above. It's a routine called 
FindProcessBySignature, that scans the process list until it finds a 
process with a given application signature, it returns true and die 
process serial number if it finds a mat£:h, false otherwise, 

PROCEDURE FIndProcessBySignature 

( 

Sigaature : OSType; 

VAR MatchingProcessJ : ProCP-SsSeriaUJimber 
J : BOOLEAN; 

VAR 

Found : BOOLEAN; 

FfiOCE DURE Ka t ch Signatu r a 

VAR ; ProcRfiRSfirialNumber: 

VAR Processiulu : Krocei^fiTtifoRec: 

VAR KeepCoina : BOOLEAN 

); 

VAR 

Err : OSRrr: 

BEGIN 

IF ProcessXnfo^proccfiESfgnature = Signature TliEN 
MatchingProcess := ThlsProcesa: 

Found TRUE; 

KeepGoing FALSE 
END OP) 

END MatchSignature; 

BEGIN (TindProccssBj'S^naturc') 

Found FALSE; (* initial assumption *) 

TraverseProcesses 

( 

CActkm:=’) CAST(FrocessActions, 

ADR(N«tchSlgnature)), 

CAnionArie :=*) CurrentAd () 

): 

RETURN 

Found 

END FindProcessBySignature; 
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First of all, compare the declaration of the inner 
MatchSignature routine with the original definition of the 
ProcessActions type. Someiliing is missing: What has happened 
to tl)e Actio nArg? 

'ilie answer, of course, is that this is now an implicit additional 
aigument, being the outer routine's stack frame pointer! When 
RndProcessBySignalure passes the addreSsS of MatchSignature to 
TraverseProcesses as dte action routine, it tells the latter to call it 
with that additional aigumeni, which is the result of calling die 
function CurrentAS. This is delined as follows: 

PRGCEDUl^E GtirreritA6() : LONGCARD: 

COBK 

02E8EH: (* uiove.l 36 , (sp) 

It returns the value tiiat Is currently in the A6,which is die 
slack frame register — exaaly what the inner routine needs 
when it's called, 

'Ihe main ugly dung alK>ut this ret:linique is tkit Modula-2 
d(x?sn’t allow you to pass a nested routine as a rouime value; this 
is only allowed for globally-declared routines (as in the sorting 
example earlier). Luckily, Metrowerks allows you to use the ADR 
(addiess-of) function on a nested routine, and you can do a CAST 
to force the result of this to the appropriate tyjxr. (Unfbminatefy, 
die pi compiler dtx:sn't seem to support this featumJ 

Why not just declare MatchSignature globally outside 
FindProcessBySignature, and avoid this triekiness with slack frame 
pointers? The reason is Lieamse, ii\scead tjf passing the stack 
frame pointer as die additional argument, youll now have lo 
pass pointers to the local variables Found and MatchingPracess. 
Or if you try using globals instead, your code is no longer 
reentrant! This may not seem a big deal ai dtst sight, but it’s very 
important in library ccxle, which will lx.* written once and reused 
in a wide variety of situations you never envisaged. Alternatively, 
you could combine lx)Lh the Icxal variables into a single 
structure, and pass the address of dial. That will work, but you 
lose stjme of the simplicity of the nesting version, 

Be.sides, the MatchSignature routine doe.sn't need to fx: 
visible globally. One of the safely principles you learn when 
you’re writing large programs is; if something dtx*sn'l need to be 
visible globally, don't make it so. In a huge piece of s^iftware, the 
complexity conies not from the numlx.T of parts, but from the 
numlx-T of potential interactions between tliem. To minimize 
unwanted interactions, Uhngs should only Ix" accessible in i>lac:es 
where they need to be, This is exiled infornmtkm hiding. 

There is fine subtle pitfall with static hnks you need to watch 
out for. Consider die Following ccxle fragment: 

PROCEDURE Parent; 

VAR 

TargctFtocess : frocessSerlalHumber; 

I’ROCEDURE Sister 

( 

VAR ThisProcess : PraccssSeriaiNumber: 

VAR Procsssitifo : ProccsslnfoRec; 

VAR KeepGoing ; BOOLEAN 


ifTbisIsTheOnelWafit THEN 

TargetPracesG TbisPrc'cess; 

KeepGotng r" FALSE 
¥m CtP) 

KNO Sister: 

PROCEDURE Brother; 

BEGIN 

T raver seP r oc es s es 

C 

CActifMi :=•) CAST (ProcessActions. ADR (Sister)) i 
(*ActionAfg :=*) GurrentAfiO (*'“WRONG “b 
) 

END Brother; 

BEGIN CPamitO 
Brother 
END Pareni: 


What is wrong widi this? The problem is, that die use of 
CurrentAGO in Brother means dial it is passing Sister a pointer to 
its own stack frame, mther than the one Ix'longing lo Parent! This 
means that, where Sister expects to access variables kxal to 
Parent, it accesses ones local to Brother instead. Itiis is obviously 
wrong, since the language rules dfin't allow variables kxxJ to 
Brother to lx* directly visible to Sister. 

'llie following is one way to modify thi.s to work correedy: 

PROCEDURE Parent; 

VAR 

Pa rentA6 : LGNGGARD: 

TargctPrcK:ess : ProcessSerialNiirabcr; 

PROCEDURE Sister 
{ 

VAR ThisProcesit ; ProccssSeriaXNujqber; 

VAR ProcessTnfn : ProceaslufcRec; 

VAR KeepGoing : BOOLEAN 


BEGIN 

IFThisIsTheOnalWant THEN 

TargeTProces.q := ThlsProccss; 

KeepGoing PALSE 
END TIP) 

END Sister: 

PROCEDURE Brother: 

BEGIN 

TraverseProcesses 

I 

CAaion ;=“) CAST (ProcessActions. ADRlSister)). 

(*Acii(>nAr^j :=“> Pa r efi l A & 

) 

END Brcirher: 

BEGIN rParciJi') 

ParentA6 CurrentAfiO; 

Brother 

END parent: 

Here die CurrentA6() call has been moved to Parent, kind its 
value saved for y,se by Brother when exiling Sister. 

The rule is simple: when calling a ne.sted routine, you 
must always pass the stack frame pointer for die routine 
texfually ifnmedialeiy cmckmng the one you want to call. If 
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The TCP/IP Scripting Addition allows you to quickly 
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FTP Parameters 


I 


Set these paran 
(sending) files 1 


Telnet Libre 


FTP Host 
Directory 


s 


User ID 


Password 


m< 


Type of file tra( 

O MacBinary File 


'W Description: 


Telnet Library vt.O 

Copyright © 1995 Mango Tree 
All Rights Reserved 


. I Bin ro 

Record Stop Run 


set my_te1net^tream to teliM 
tell my_telnet^tream 

try 

connect(your_ho3t) 
read-unti 1 text ("loc 


you stick to this rule, all the more complicated cases — 
references to local variables up more than one level, recursion, 
inner routines c^alling outer ones, and so on — are guaranteed 
to work correctly! 

ApPUCATION to OTHSI LaNGUACpFS 

For some odd reason, most Mac programmers don't use 
Modyla-2. Most use C, and must of the rest use Pascal. And 
you’re wondering: how applicable are these tedmiques to 
I hose languages? 

You can use them to some extent. Modula*2 is mcKleled 
fairly closely on Pascal (tliey were both designed by tfic same 
person, after all), and Tm pretty sure all ilic Mac Pascals use A6 
as a stack frame pointer in the same way as Mtxliila-2. 'iTiere arc 
two main drawl>acks to Pascal: 

• Tfiere are no routine types. Once you lake die address of a 
procedure or function, you'rv completely on your own, 

• I understand THINK Pascal doesn’t even allow you to take 
the address of a routine that’s kx:al to anodicr routine, lliat 
means you can't use any of ifiu A6 stuff 

Note that it Ik possible in Pascal to pass a routine us an 
argument to another, in a type-safe Fashion. Tills feature is 
powerful enough to deal with ail die examples using static links 
1 iiave given alxjve. However, it doesn't allow you to save 
routine addresses in data structures, which can come in useful in 


some cases I haven’t covered in this article. 

Tlie major drawback widi C is that it doesn't allow you to 
declare one routine inside another 'iTiis means you have to go 
dirougli the extra complexity I mentioned above in passing 
additional arguments to action routines. At least C has proper 
pfocedure and function types. 

Conclusion 

Assembly-language hackers are cKCiLsionally fond of a 
prognmuiiing technique known a.s ^elf-modifying code, where an 
instRiction sequence pokes some biLs in an instruction elsewhere 
in the routine before executing it. 

1 want 10 make a clear di.stincuon l)etwceii self-modifying 
code, and the techniques for genercaing code at mn-Hme limi I 
have been de.scribing above. Self-modifying code was a 
technic|uc concocted to squeeze a few more instruction cycles 
out of time-critical code. It has l)een quite rightly criticized as 
leading to programs iliat are hard to understand, hard to reuse 
and hard to maintain. 

The techniques 1 have been describing, on the other hand, 
are more sirucnired ilian tliis. The code which is being genemted 
at run-time follows a simple, easy-to-uneJerstand fomi, and its use 
is really quite straightforward. My aim has not l:)een to optimize 
time-critical cfxle, but precisely to create code which Ls easy to 
understand, easy to reuse and easy to maintain! D 
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TOOLS OF 
THE TRADE 


by John Schettino 


PowerBuilder Version 5 


Cross-Platfortn 
Database 4GL 

Big Time 4GL for Macintosh 

Tlic* PowL’rBijilder product line from 
Powersoft (a division of Sybase, Inc.) Ls a 
cross-platform database application 
builder TVe always called these things 
4GLs lK‘cause they are databasescentered 
environments that include a custom 
programming language. application 
framework, anti database hack end. 

PowerBuilder is the mother of all 4GLs, 
since it is available on every major 
hardware and operating system platfomi 
and it can access data stored in a 
comprehensive set of diiialrases. If you’re 
cmating enterprise or vertic'al applic^ations 
that have heavy database requirements, or if 
you need to cicate font-ends to access data 
.sU>red in non-Macintosh database servers, 
PowerBuilder is the pnxltia for you. It’s 
also the product for you if you need to 
support non-Macintosh systems including 
Unix and Windows with a single prodtia. 

At just under tliiee tliousand dollars for 
the Fnterprise version, this is not an impulse 
purchase. This prcxlutl is aimed squarely at 
in-house IS departments, database 
c:onsultants, and vertical tnarket dc"velopers. 


Big Time System Requirfaifjnts 

Tlie product is delivered in a typical large software box. 
What is surprising to me is that this box was actually Oiled with 
manuals and a CD wallet containing four CDs. Fortunately only 
one CD contains the product. Tlie odier three cross-platform 
Mac/Windows CDs are filled with on-line documentation and 
reference material. 

You can run PowerBuilder on 680x0 processor machines, 
1)01 you’ll get better performance on a PowerPC proemsor 
computer. Memory recjuiremencs are also fairly stiff, A minimum 
of 16MB on a PPC is suggested. I evaluated the product on a 
710()/80 with a 256kb cache and 40MB of RAM and it ran 
comfortably fast. Yrnjii also want to have a fair amount of free 
disk space. I installed iIk* “Fasy Install” package onto a volume 
other than the System volume and it ended up installing 13MB of 
extensions into the System folder and 50MB of files onto the 
selected volume. 

The Mt>THEK of aix Learning Curves 

PowerBuilder is complex. That’s not a criticism, it’s a 
warning. You will not sit down with this product and start 
Imilding applications. Instead, you’ll have to start climbing a long 
learning curve to ixfcome proficient. To that end, the 
documentation Is split into two piect^. 

Printed Documentation 

Ihe printed documeniaiion includes a 15 page installation 
guide that walks you through the installation and tells you what 
gels installed wliere. Following that is a 235 page getting started 
tutorial. You'll want to s|>end time here actually working through 
the tutorial example. If you do, you will visit m<xst of the 


John Schettino is an author and Senior Member of the Technical Staff at G'l'E Laboratories, Inc. He is the co-auihor of the 
[jotjks HASIC for the Neuron: Programming for the Newton with NS BASIC md AppleScript Appiicatiom: Building Applicaiions 
with FaceSpan arid A/pleScripc IxHfi published by AP Professional. He is also a contriliuting editor for the Handheld Systems 
Journal ami for the web cZinc MobilLs, where he writes about Newton programming. You can reach him via 
hllp://membcrs.aol.com/pdciohrLS/. 
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commonly used tools in the environments You won’t learn 
anything about the PowerScript language used to pR)gram in 
PowerBuilder, but you will get to type some of it into the 
example at the appnjphaie places. Tlie tutorial is very nice: not 
only do you get a tour of the environment, but the application Is 
built in the steps that you would when creating your own. 
Each section begins with a iliree part overview: What you will 
do, How lt>ng it win take, and What will you learn. This helps 
keep you focused to the task ai hand. 

The next document is called the Project Prijiier. This is a 214 
page “h{)w to" guide that explains one method for tackling a 
problem. It provides a life-cycle approach to application 
development. Ihis kind of road map is vital when you're 
working on a large problem, and this document came as a 
pleasant surprise to me. Even if you use some other development 
method, you should scan this dcxaimeni to see where and when 
the PowerBuilder t<K)Js are applied. 

Tlie largest document is the 580 page tome “Connecting to 
Your Database." It is a reference guide explaining how to connect 
your application to eadi of the supported database back-ends for 
PowerBuilder This document can be completely skipped wliilc 
you leam the environment and tools. Only when it amics time to 
access one of those dataliascs would it l:)ecome net'essary. 

Additional documents include the usual license 
agreements, customer service references, and third-party 
directories. You can optionally order printed versions of the 
electronic documeniation as well. 

Elcctmnk Documentation 

As you probably realized, there is really no user’s guide or 
comprehensive reference in the printed dcxaimeniation; dial is left 
to the CDs, Three are supplied: die Reference CD is specific to the 
Macintosh prtxluct. Here you w^ill find all the expected dociiinents, 
including the Guide to Documentation. The electn)njc documents 
viewer application, as well as one or more of the lxx>ks, can be 
installed onto you system for access without the CD, You can also 
print your own hard copy version of selected chapters or entire 
bcxiks. Searching Is also supported by the viewer. 

Two "InfoBase” CDs are provided. ITiis is a subscription- 
based information delivery system. You have instant accc^SvS to 
every tip, problem and work around, and general information in 
the PowerBuilder system. There seemed to be a lot of valuable 
information there, and you can print or search as widi the oilier 
electronic docaimentalion, 

Let\s Build Something! 

By now yoifre probably as eager as 1 am to aauaJly build 
something with PowerBuilder. One of PowerBuilder's main 
strengths is in cross-platform development When ycHj’re working 
on an application you tan use a wide range of dalal^ase [jack- 
ends, or you can use the supplied SQL Anywhere Database. 1 used 
that database for the review. To put PowerBuilder through its 
paces i'll create a simple database, a record entry and search 
screen, and a report. Tills will give you a feel for most of the tools. 
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Where Do You Want To Go Today? 

You begin by launching ilic PowerBuilder environment. It 
ifi immediately apparent that this is clearly a Wiridows95 
application running on a Mac. Once you get over the initial 
shock, the environment works well. If you happen to Ise familiar 
W'iih Windows95, you'll find aM your favorites here: entiless rows 
of icons, status bars, tool tips that pop up when you move the 
mouse over an icon, tab[>ed dialog boxes, and Wmdows95-style 
collapsible hierarchies abound. On the plus side, using 
PowerBuilder on a Mac or a PC should be pretty much the same. 

Database Definition 

Each major task has a corresponding tool (called a painter) 
in PowerBuilder. To work widi databases you use the Database 
Painter. Once you open a painter, you get another row of icons 
for opemtions specific to that painter. You can create a new 
database or work with existing daialya.ses from any of the back 
ends supporting by using tlic painter. I was able to quickly define 
a pair of related tables using SQL Anywhere (a self-contained 
relational database back end that .sfiips witli PowerBuilder) in the 
painter. Figure 1 shows Lite lai>les and their relations. 
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Figure L Dulafjme Patnier. 


You begin by connecting to im existing daUibase, or creating 
a new ont\ Then you create or edit each ta[)le. Tlic tabic editor 
allows you to add or mtxlify fields. You cteate key fields, 
indexes, and other attributes of a table by accessing it's 
Properties. This is another one of those Windows95 conventions 
that appear throughout the pnrxlucE. Once you're done, you save 
the table. This generates die eorreci SQL to create a table, and 
sends it off to the back-end. Editing a table with data in it does 
cause you lo lt>se that data, so you'd have to extract the data 
iDefore making tlie change, and then re load the data afterwards. 


This is very normal for Unix relational databases, but it may 
come as a surprise to someone used to Mac databases. 

Applications the Template Way 

PowerBuilder applications are a colleciion of resources that 
are contained witliin an application library. Tliey may include 
menus, Multiple D<x'yment Interface (MDl) frames tliat include 
icon bars, and windows. Tt^ make a new application you begin 
by creating a new application library. .Sinte most PowerBuilder 
applications contain similar components, you are given the 
option of fiUing your new library with a commonly used set of 
objects, 'fhis greatly speeds initial development. Figure 2 shows 
my appliaition's initial objects, as well a>s the Application Painter 
icons. Although you can name your application and its 
components however you’d like, you'll need to restrict yourself 
to ihe Windows 3T dot y style names if you intend to run the 
application on that platform. 



figure Z Appfkaihn Painier. 


The application library (like almost everything else) has a 
[>ro[xrty window where you control settings such as the default 
fonts and finder icon it uses. You can also add library search 
paths to the applicatkm here, PowerBuilder supports 
user“generaLed and third-party libraries. Tilts is great for reuse, 
as well as for creating a ctmsisLcnl look ihroughoiii a set of 
related applications. 

Tlte envirfvnment supports rapid development very weD, 
You can always run the application in lis current state by clicking 
the Kun button. Even the basic template application can l>e run. 
As you would expect, you can edit the windows supplied in the 
template, add new windows, and delete windows in an 
application. Adding a new windt>w opens the Window Painier. 
This is where you draw the interface for a particular window. 
The window iuself may t>e mtxkil (called a Respon.se Windowd or 
not. It can be set to bo resizal)le, to include a title bar (widi out 
without the zoom and minmiize controls.) You set these using 
ilie window's Properties menu. 
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All ihe usual window elements (called controls, in the 
Windows93 nomenclature) are available inclutling various line 
and box tools, checkboxes, radio Itutions, static and editable text 
fields, buttons, scroll bars, and others. Preview mode allows you 
to try out the window exactly as it will be rendered, to see if die 
controls are working as you expected. You have total control 
over the tab order of the different controls, and you can set the 
initial stale of each contrors visible and enabled allrihutc from 
widiin die Painter. 

Coding in PtiwerScript 

Tlie next step in application developnient is to add 
PowerScripl code to actually ofxjn a window and process the 
user’s input. Using PowCTScript is a bit like using AppleScript 
wiiiiin FaceSpan: You open up the Script Painter for a [nirticular 
object in the library, and then you add script ctxle to prcK'ess 
specific events that are sent to that olijeet when the applic'adon 
is running. Tills event-lrased style of programming should lie 
familiar to most Macintosh programmers. The litirdest part of this 
style of programming is learning exactly which evenis are 
generated for a particular action, and where they will be sent. In 
tills case, the documentation rxmuiins plenty of information. In 
addidon, you gain some expasure to the most commonly used 
evenLs by working the tutorial ami kxiking at the samples, 

I added a script to the application frame window that opens 
the login window when the a[>plication Is run. the PowefSt:ripL 
code and the Script Painter are shown in Figure 3- The scrijit 
editor only shows the script for a single event or user-deFmed 
function. ‘Ibis is less confusing for tlie beginning developer but 
may fiecomc tedious when working on complex applicaiioas. 
Tiiere are a few helplul tools in the painter for conuiienting or 
un-commeming lines of cxKie. C++ style commems are 
supported, as is syntax coloring. You can alsti get txiniext- 
spccific help within the painter by selecting tile item and 
pressing shift-Fl, 


^ it iim fait \inirif.|i Oeitjn Oectinc iPinJwti 


I ^iPteiiami wsl q|Ql niglti Bl: 


I ftw i».,jc fnwi- 1 lnaiii* r#tiiriM tonj 


_____ 

w>cttwHii Pa^Hrguni...'^r| bunmi t| 

^ * mFTHJi lent Ipr plBifqri^ */ 

wr^jMLfniNiutiiMi {menu^d) 

/• Crowe indl&l shsflt •/ 

// Wl.npwthnnl 0 


figure 3* Script Painter. 
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request including the user id, password, and database name. 
When you’re administering the database you need to set up user 
accounts and grant the necessary privileges to each user 

Menus 

PowerBuilder include a Menu Painter for creating the 
application menu. This painter supports detlnidon of keyboard 
command-key equivalents {called accelerators in the Wtndow's95 
tradition) and separators. 'Ibere is no access to tlie standard Apple 
or 1 lelp Menus other than ihe “Alxiut diis applic’ation” menu item, 
and hierarchical menus are not supported. Full support Is given for 
a Toolbar that corresponds to each menu. For ciich menu item you 
can specify a toolbar button with an icon (several standard icons 
are supplied) and optionally a puU-down menu. You t:an also 
define menus that are specific to a window. In ihts case an 
additional tool bar is dlsplaytxl when tliat window' is frontmost. 
You must iitiAch a .scrifU to each menu item to sent! user events to 
your application when the menu item is seletaed. 


To use a Database in an application you must establish the 
connection to the desired database tlirough a script in the 
applicaiion. The script is attached to a transaction object within 
the lib^ar)^ It contains commands that set up an SQL connection 


Database Accc^is 

FowerBuilder inciudes the patented Data Windows ttx>l tliat 
automates much of the process of accessing displaying, and 
u|xi:iting databa.ses. Although you can (and probably will) design 
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your own ckia entry, access, and display windows, using 
Data Windows can sjx-*cd applit^ation development in tlic eariy 
stages. In my application I used a DataWindow to display a sample 
table. Figure 4 shows the DataWindow configuralion window, 



figure 4. iktiaWindow Conjiguration. 

Once you selea ilie type of window, you select die table 
and Reids to present, You can specify a sort ortier for each field. 
You can even specify complex SQL oj^eraiions such as JOlNs 
using the Painter. Once that is completed the DataWindow 
Painter opens, showing die windcjw. You can customize the field 
tides, detail lines, .summary lines, and fcMricr for the window 
here. 'Flie summary and f(X)ter are used for [printing. When this 
window is displayed, the user is able u> Add, Edit, and Delete 
entries, as well as filter the infomiaiion [nescnied, all without a 
single line of SQL. 

One common use of the DataWindows is to cTeate a 
Ma.ster/Detail window. Ihis is a window^ containing two sub¬ 
windows. The first sul>-window contaias a DataWindow in tabular 
format for searching and reviewing recf>rds. 'Ihe second window 
ct>niains a Derail window where all the erlitable fields of the 
currently selected record are displayed. The tuiorial guides you 
through the process of creating one such Master/Delai! window', 

SQL Tools 

PowerBuilder is designetl tf> acce.ss SQL-based databases. You 
can write your own SQL statements within scripts, or use the SQL 
Painter to construci statemenfs and emlied them in your scripts. 
'Ihe painter can cx>asirut:i ([ueries asing StiUiCT that extract a 
single row, or it can construct a CURSOR that you use to visit die 
matching rows for the query\ The painter suppoas advanced SQL 
features including niulti-iable JOlNs and functions. I found the 
painter to be very helpful in creating complex SQL statements. 

PowerBuilder also includes a tool called the data pipeline 
(along witli its corresponding painter) that you use to set up fast 
copy actions betw eeo databases. This moves data iietween tallies 
(or databases) as fast as the databases can do it, rather diaii 
shipping each row of data to your application and then back out 
to I he database. 

Sybase SQL Anywhere 

IVe already mentioned SQL Anyw^here brietty before. TliLs is 
die liundled relational database for PowerRiiilder 5-0, It provides 
all the features needed to create Macintosh databa.se applications. 


In odier wtirds, you ckin't have to use a third-party datalya.se with 
PowerBuilder. SQL Anywticre stipports multiple databases of 
unlimited size - in faa databases may span multiple files that 
exist on different drives, U includes a server application and a 
separate administration application that allows for database and 
table creation, user access control, ancl other administration 
tasks. Most of these tasks can be pcrfiirmed using a nicer 
interface from widiin the PowerBuilder environnicnl. The server 
application is started autonmdcally w^henever you access an SQL 
Anywhere database for the first dine. 

SQL Anywhere is a full-featured SQL database. It supports 
the Open Database CormecUvity (ODBC) interface developed by 
Microsoft and used by PowerBuilder. Its feanires include 
transactions, iniasaction log mirroring, triggers, funclioas, and 
other advanced capabilities you*d expea in a relational database. 
There are two versions: a network server (not part of the 
Pow^erBuilder package) for multi-user access, and the database 
engine for single user standalone use. llie standalone version Is 
bundled with all versions of PowerBuilder. 'I'he standalone 
engine docs ntsi .support network connection.s, and otherwise 
prcKesses aU requests exactly the same as the server version. 
That means you can am your apf)licaiion with a network server 
in the future if your needs change. 

Database perfonnarK e is hard to judge, Ixx'ausc it is so 
dependent on the underlying 1 hardware. Rather than quote you 
hard numbers, Pd like to give you my impression of the speed 
of SQL Anywhere as compared to FileMaker Pro 3-0. !n general, 
SQL Anywhere outperformed FMP by a taaor of two while 
performing single table insertions, deletions, and queries. 
Complex multi-table <njeries were two to three times fa-stcr. In all 
fairness to FMP, it’s a lot easier to set up a simple database there 
and FMP does not support SQL. 

SQL Anywhere allows you to define multiple keys and 
multi-field indexes to speed cjueries. It seems to do a decent job 
of employing all available keys and indices in a mble during 
query execution. As with all databases, the more indices you 
tie fine, the more insert and upcLue operations prolong. I noticed 
a slight Increase in update times on indexed fieltls in a database, 
but nothing out of ihe ordinary. 

Third Party Databases 

Performance of third party databases Is dependent on three 
factors: raw performance of the database, raw perfonnance of 
and congestion on the network used to acc:ess the database, and 
raw fX-Tformance of the interface. PowerBuildcT uses ODBC to 
access a wide range of daiabase.s under Windows, According to 
the "^Connecting to Your Data.lrases'' Dcxrument the only 
Powcniofi supported ODBC database for Macintosh is SQL 
Anywhere. You may get an onBC-compliant driver fcm your 
database vendor to access its data via PowerBuilder. 

PowerBuilder Enterprise supports native database 
interfaces for addirional third part}^ databases. These include 
Oracle TO and 7J, and Sybase SQL Server 1 made no attempt 
to test the access speed of these databases. Y<m can firtd lots of 
benchmarks of Oracle and Sybase databases on tlic web by 
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scLircliing for '‘rdbms performance comparison". You can 
assume that a PowerBuilder application using one of these 
databases will achieve similar performance. 

Otlier Goodies 

Ibere ts simply no way to cover every feature in 
PowerBuilder. Suffice it to say tliat if you're kxiking for 
something that I haven’t specifically mentioned here, it's 
probably in PowerBuilder in some form! fve only glossed over 
the PowerScript Language, but it is as complete and robust as any 
"IGL I’ve seen. ’Ihere is a large and useful set of functions, the 
ability to create user-defined functions includes a simple yet 
powerful interface specification ux)l, and support for kx^af 
global, and instance variables is included. There are also a 
number of other tcxils for creating quick reports, administering 
databa.ses, and application debugging. 

Debugging Applications 

Each painter in PowerBuilder checks the validity of the 
window/menu/script/etc. when you close the window. Tli;U 
lakes care of the compile-time syntax errors, but what about the 
semantic errors? You know, bugs in the scripts. The 
PowerBuilder environment halls execution and displays an error 
dialog when it attempLs to execute an erroneous script. If you 
enable debugging mode, then you c’an selca each script and set 
one or more breakpoints. Once all the scripts have their desired 
breakpoints you can run the script. When a l^reakpoint is 
reached the debugger returns. At this prjinl you can examine and 
change variables values. Figure 5 sliows the debugger, Variables 
window, and a modifitration window. 



Figure 5* Debugging Bnmronment. 



returns. In other words, tliis is a fairly compleLc and powerful 
debugging environment, lacking only some nice-to-have but 
non-essential features. Debugging is one situation where having 
only a single function displayed in the Script Painter windows is 
a real disadvantage. Forcing you to select each script one at a 
time to set breakpoints makes the debugging pnxrcss more 
tedious that it should Ix!. fm still quite impressed with the 
debugger, it just could be easier to use. 

Creating a Shipping Cross-Platform Application 

Here's the big payoff for using PcjwerBuilder, Once the 
application is running the way you want, you just use the Project 
i>utlon to create an executable file. Enter a name and click the 
Save button and you get one last painter to fill in. 'Ihe Prajecl 
Painter allows you to specify the application signature, minimum, 
and preferred heap sizes for tlte Macintosh file. You can also set 
the optimizmiijn choice (speed vs. ,size, or none) and the 
executable format (Mac machine code using Eat, PPG, or 68k 
code, or cross-platffxm pcode,) To move the project to a Unix or 
Windows platform you need only copy the application library to 
the platform, open it, and create a new Project. 


Ytju can set additional breakpoinis, continue execution, or 
single-step execution. You always ‘'step into’' functions - tliere is 
no way to step over a funaion or to continue until a funaion 


What About Windows? 

PowerBuilder for Macintosh is clearly a port of die 
Windows95 product. I have mixed feelings about dial. On the 
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one hitnd, I know this means that iliere is quite probai)ly a lot of 
cominon ccxie between liie two products. This means the Mac 
version will 1^' well supported. It means that Ptjwersoft can save 
support and dtKumentaUon costs by using common manuals and 
support personnel, II also means that you could move to ihe 
Windows95 version of the producit and retain 99% of what you 
learned here on the Mac side. Finally, you really do get used to 
die interface pretty t^uickly; it's a consistent and well done 
Windows95 interface. 

On the other hand, it would not have been immensely 
diffic;uk to recast key ptritions of die user interface into a more 
Macdike look. For the average Mac developer w^ho is familiar 
with the CodeWarrior or Symaniec IDEs PowerBuilder will feel 
pretty alien at firsL Using Windows95 tenninology for the 
window elements means that you dtm’l get that insiant 
recognition you'd exped as an experienced Mac developer. In 
other words, it just throws a small wall between you and the 
work at hand. It's the price of admission for using PowerByikler. 
1 think it’s wnrih it, but I could do without it. 

Assessment: 4GL Heaven 

I did nor nin into any optTational emirs while reviewing 
PowerBuilder, I had some difficulty using SQL Anywliere, almost 
all of which I’m certain were of my own doing. The product 
perfonned reas<inably well on my somewhat old 7100/80, Fm 
sure it would lie quite snappy on any of the modern 603 or 604 
PPC based Macs, 

PowerBuilder is a full-blown and very capable Unix-class 
4GL (in [xiwer) with a state of the art Windows95 user interface, 
running efficiently on PowerPC Macintoshes with 32MB or more 
memory installed, f think that's a pretty fair asses.sment. Y<iu cm 
create powerful front-ends to a large number of existing third 
parry SQL databases, create new applications using ihe supplied 
SQL Anywhere Seiv'cr, and design your interface to be Mac-like, 
Windows-likc% or however else you'd like. You gel a full featured 
development environment dial includes visual layout of 


windows, iiicremenLal development, and decent debugging. You 
get powerful building blocks such as the Data Window to speed 
development. You get cross-platform support for all the major 
hardware and operating systems platforms. 

You also get to learn a new programming language 
(PowerScripL) that is not exactly like any other language I'm 
familiar with, and you get to deal witli the Window595-style user 
interface. That interface is (arried throughout the product, even to 
the on-line manual viewers and sample applications. The interface, 
coupled with tlie sheer complexity and scope of PowerBuilder, 
makes the initial learning process pretty daunting. Sticking to the 
tutorial, brow.sing (and using parts oD the large suite of sample 
applications, and reading the on-line documentation eventually 
imparls a degree of proficiency to you. If yt>uYe looking for more 
help, your loc:al bookstore firohably stocks one of the many lx>oks 
and magames devoted to PowerBuikler 

If you're just making Mac-only database applications with 
small or simple data access requirements then one of the less 
expensive and less capable Mac-only or Mac/Windows 
database programs, such as FileMaker Pro, would probably 
serve you better than PowerBuilder. If ycni want to create 
enterprise, vertical, or cross-platform database applications 
then the power and feature set of PowerBuilder make it a 
compelling choice. 

If you're interested in PowerBuilder 5.0 for the Macintosh, 
but you don't have need for some of the advanced features, 
ihere is a “Uesktop" version that costs $295. fhis version lacks 
native database drivers bui still includes the SQL Anywhere 
darabase. It also is missing some features such as version 
control, support for distributed a]>|>licaiions, and support for 
external C++ code, but ytui’ll still be able to create stand-alone 
applications that run on the Mac. For a powerful SQL-based 
database with a .strong interface builder this is really worth 
consideration. Although I didn’t review the PowerBuilder 
Desktop version, it Is es,scnlially identical to the reviewed 
version except Ibr these advanced feaiures. B 
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Dilbert ” hy ScoU Adams 



OOGBEIKT'S TECH SUPPORT 


I THINK I KNOUO 
DHAT YOUR PROaEM 

15 ... 


TAKE ALL THE PARTS 
AND ARRANGE THEAA 
IN NEAT PILE5, NOUJ 
STAND ON YOUR CHAIR 
SO YOU CAN SEE. ABOVE 
YOUR CUBICLE tUALL... 



NOU SHOUT "DOES ANY¬ 
BODY KNOW HOM TO READ 
A AAANUAL?" 


©I9i&? United Feature Syndicate, Inc, (NVCJ 
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PROGRAMMER'S 

CHALLENGE 


by Bob Boomtra, Westford, MA 



Who Owns the Zeur\? 

Tm finishing up iJiis column while at the lieach on vacation. 
The place we’m staying is kind of intefesting, in that all of Uic 
condoininiunis look exaclly alike, except diat each has a 
different color cl(x)r. Even more mteresting, each condominium is 
tKtrupied by a person of a different natiomility, and each person 
owns a different kind of pec Tliere are three condcnnittiuins, 
with red, green, and blue diK>rs. They are occupied by an 
American, a Qmadian, and an Australian (but not necessarily in 
lliat order). The American vacationer lives in tiic house with the 
red door The person in the house with the blue door owns a 
dog. The pers<3n who owns the cat lives in the middle house?. 
And the house with the green ckxx is immediately tt> the right of 
the house with the blue dfxjr So, who owns the zebra? 

Well, T really am on vacation, but pets aren’t allowed, die 
d(K)rs are all the same color, and 1 don't know the nationalities 
of my neighlx)rs. But I did ojn acK>ss a zebra puzzle recently, 
and it seemed like a go^xl logic problem for the Challenge, fn the 
above example, you can reason tlirough the four clues to rule 
out most of the 2l6 possible combinations and conclude tliat the 
American owns the zebra. pR)blem complexity grows rapidly 
widi tile numlx^r of variables - in a problem wiih 5 variables, 
there are more than 24 thoiLsand million (that's 24 billion for 
Americans) combinations, but die zebra can be found with as 
few as 14 clues. 

Your Challenge diis month is to write a program diat will 
reason through a .set of clues and provide a solution consistent 
with all of die clues. The problem will be provided in a stilted 
syntax - for example, the sample problem above would be given 
as follows: 

Am^ricun ISA poraon 
Canadian ISA pEt^on 
Australian ISA person 


redUoor ISA house 

greenDooc ISA house 

hlnf»Door ISA house 

dog TSA per 

cat ISA pel 

zobru ISA pOL 

person Iives_iii house 

person owns pet 

American lives_in rediJogr 

blueDoor owns dog 

cat TS WCATED m_HIDDLE 

greenDoor THMED ilIGHT_OF blueDoor 

SOLVE person owns zebra 

ANSWER person house pet 


7Te nine ISA relations define die variables (person, house, 
pet) and the values those variables assume in the preddem. The 
next two statements define the relations (lives_in, owns) 
between selected fiairs of variables. The next four statements are 
the clues describing relations Ix^rween values of variables, 
discussed further lx?low. The SOLVE statement defines the 
question that you arc to answer, and the ANSWER statemeni 
defines the format that your solution should take, 
dlie prototype of the code you sliould write is: 

void WhoOwnsZebrat 

long prob lemDi dEns ion. f* number of problem variables */ 

1 ong rtumCluoo. /* numkr of dues provided */ 

cluestL /*lhedues*/ 

CStr255 solutfoni] t* storage fur prubleuiDimotsion n^suli strijig.s •/ 


fhe problemOimension parameter dcscrifx?s the number of 
variables in the fimblem you are to solve (in the example above, 
problemDimension was 3). 4be number of clues prtjvidcd is given 
as numClues (17 in the example), Tlie solution is to t>e provided 
as a se([uenc:e of problem Dimension n-tuples that form a solution 
to tlie [iroblem, where each n-tupie is a serjuence of values in 


THE RULES 


tlere's how it wiorks: each month wc presti'ni a new pnigramminp 
dialknjie- llrsi, write some code tliat solves the challongc. Second, opiimizti 
ytiur cfKk (a kx). Tlien, submit your solution to MacTech Magazine, Wc 
choose a winner basted on ctxie corfecUiess, speed, size, and elegance (in 
diat order of imponance) as well as ihe submission dale. In die event of 
multiple equally desirable .soJutioivs, we’ll chot>se one winner (with 
honontirle mention, but no prize, given to the runner up). The prize for each 
moniii's best .solution is a $100 credit for Developer Depot"^”, 

Unless staled tahenvise in die problem statement, die following rules apply: 
All sr>lntions miisr l3c in ANSI compatible C or C++, or in Pascal We disqualify 
entries with any assemJily in ihtMn (t:xft.‘pi ftir challenges spedfitally slating 
otherwise.) You may call any Macintosh TfHillxix routint! (eg., it dix.'sn’i matter if 
you use NewPtr instead tjf mahoc), Wc compile all entrks into native PowerfC 
code widi aaiipUer opiiixis set to enable all available .speed optimizaiEons, The 
ckrveloptneni emaronmeni to lx? used ftir selecting die winner will be stated in the 
prxiblcm. limit yotir code to 60 eharacteni per line compress aixl libdiex the 


solution; this helps with e-mail gateways and page layouL 

We publtsli the solution anti winners for each mondfs Programmer's 
Challenge three monllis later. All submissions must he ret'civixl hy tlx? 1st tlay 
of the im>nth printed on the fremt cover of this Issue. 

You can get a head start on the Challenge by reading the Progranuncr's 
Cliallcnge mailing list. It will he posterl to the list on or lx;fure the IZtli of the 
preceding month- To join, send an tunail lULserv^listmallxplain.coni with 
the subject "subscribe challenge-A”, 

Mark solutions *‘AtiJi: Programiner's CliaUenge Solution" and send it hy 
e-niail to one of die Programmer's Cliallenge addresses in the "How m 
Communicate With US'* section on page 2 of diis issue. Include the solution, 
all related files, and your contari info. 

Mac l ech Magazine reserves the right to pubiLsh any solution entered in 
the Programmer's Cliallenge. Authors grant MacTcch Magazine tlie exdu,sive 
right to publish entries without limitation upon submUsion of each entry. 
Authors retain copyright-s for the code. 
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the order described by the ANSWER clue* In the cxiimple ^iven 
above, one solution would Ix!: 

Australian bluc^Door dog 

Canadian greenDoor cat 

Amatican radDoor zabta 

The clues will consist of a sequence of casc-st‘asitive tokens 

separated by spaces. The clues will take one of the following 
forms, where tokens in all caps are reserved words: 

value ISA variable 
variable relation variable 
value relation value 

value IS LOCATED [AT_LEFT | 1N„K1DDLE | AT RIGHT] 
value [NEXT„TO ] IHMED_RICHT_OF | IMKED LEFT_OF] value 
SOLVE variable relation value 
ANSWER variable .*♦ variable 

The ISA reserved word is used to define the variables in the 
problem and asscKiate legal values with tliose variables. The 
relation statement takes two forms, one that defines a relationsliip 
between two variables, and one that associates a value taken by 
one variable with a value taken by another These as^sociations 
are transitive (e.g., if the American lives_in the redDoor house, and 
the person in the redDoor house owns ilie zebra, then the American 
owns the zebra). The relations associate values, and the specific 
words used to define a relation have no meaning exce[5t to make 
the problem more readable. In addition to the relations defined 
by the problem, there is a left-to-right oalering of the n-iuples in 
the solution. The special predefined NEXT_TO, 
lMMED_RIGHT_OF, and IMMED^LEFT_OF relations provide 
infonnaiion about the relative lefi-to-righi ordering of values, 'fhe 
predefined IS_LOCATED relation associates values with three 
fixed points in the left-to-right ordering: AT_LEFT I IN„MIDDLE 
(middle position, meaningful only for odd values of 
probtemDimension), and AT_RIGHT (rightmost posiLit>n>* 

There may be more than one set of n-tuples that solve tlte 
prol>lem, so the splution you report need not be unique, as 
long as it is consistent with all the clues. Enough clues w\\\ be 
provided to uniquely answer the question that you are asked 
to SOLVE, and you may use this fact in directing your search. 
I’he n-tuples provided in the solution should lx: provided in 
left to right order. 

There are no memory restrictions on diis problem, except 
that it must run on my 96MB 8500/200. You sht)uld dealIfKate 
any dynamically allocated memory before returning. Tliis will be 
a native PowerPC Challenge, using ifie latest CodeWarrior 
environment. Stilutions may be coded in C, C++, or Pasi:al. 

Now, back to the l>each to find that zebra.,.. 

TiiKHii Mopvins Ago Winner 

Congratulations once again to Ernst Munter (Kanata, 
Ontario) for submitting the fastest solution to the July 
Disambiguator Challenge. Jhe problem this month was to 
implement a partial string matching algorithm similar tf) dial used 
in Apple's QuickView utility, with the problem complicated by 
the addition of wildcards. Eight people / teams submitted 
solutions, and five of those worked correctly. Ernst's winning 


solution was more than 15% faster chan the second place Miluiitin 
by the team of Peter Lewis and Eric Gunclrum, whose solution 
was in turn 50% faster than the next solution. 

My test cases used two dictionaries of mum than 25000 
words each, using more tlran 800 strings to lie matched lictwcen 
die two cases. Some of the strings resulted in a single match, 
while others generated several dozen, and a few as many as 2500. 
Overall, die test cases generated more than 170000 matches. 

There are two key elements to the speed of the winning 
solution. First, Ernsl creates a digest biuiiap fur each word in the 
dictionary. The digest indicates whether the word contains a 
single occurrence of particular characiers, multiple occuiTences, 
or no occurrences. The second key feature is tlie aggregation of 
these digests into pages of up to 32 words of equal length. The 
page digests allow groups of wtjrds to be eliminated from 
detailed consideration if the words do not contain the correct 
charaaers. Hie very' detailed t:ommentary provides more iasight 
into other optimizations and special t:a.ses in the solution* 

The uilile belt>w lists the execution times in seconds tor the 
comliineci test cases retjLiired by each correct entry. The oumtjer 
in parentheses after the entrant's name is the total numlier of 
CItallenge fH>ints earned in all Challenges u> date prior to this one. 


Name 

Time 

Cfxlf 

Data 

Imiguage 

Ernst Munter (266) 

1,S6 

4924 

496 

C++ 

Peter lewis (32) 

2.21 

2788 

455 

C++ 

Eric Cundium CIO) 

2.21 

2788 

4'55 

C++ 

Ludovoc Nicolle (21) 3.36 

2948 

72 

c 

Jonathan Kleid 

13^92 

3876 

16 

C++ 

Itandy Boring (37) 

22,96 

4072 

242 

c 

A. F, 

errors 

2428 

220 

C++ 

D, L 

errors 

4772 

32 

Pascal 

D, II, 

errors 

1068 

24 

C++ 


Top 20 ComTSTANTs 

Here are the Ibp ConteslanLs for the Programmer's 
Challenge. The numbers below include points awarded over 
the 24 most recent ctmiesis, including points earned by this 
month's entrants. 

You might notice that one of the entries tiiis month was a 
team solution. One previous winner was from a team, and in that 
ca.se 1 gave the full point award to both members of the team, 
fve decided that this approach is Inappropriate, so 1 divided the 
points for second place this month between the two members of 
the team. 1 also retroactively split the point award for the 
previous winning team entry. 

You might also notice that our Editor-in-Chief participated in 
this montli's ChaDenge. Eric pantcipates for the enjoyment, (In 
fact, during MacHack '97, Peter and Eric worked on their 
Disamhiguator eniry as well as on their hacks for die Hack 
Contest.) To avoid any appearance of conflict of interest, the 
prize for any Challenge dial Eric might win will be awarded to 
the auilior of the second-place entry. 
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StoneTable Break on through the limitations of the List Manager 



P.O Box 12665 
Portland. OR 97212 

68 & PPC libraries for Think C, CodeWarrior C & Pascal, MPW C & Pascal $200.00 


Includes PowerPlant Class for CodeWarrior 
International shipping (US Airmail) $10 
No royalty fees for applications 


StoneTablet Publishing 
P,0, Box 12665 
Portfand, OR 97212 
voice/fax (503) 287-3424 
stack @ teleport - com 


Row and column titles 
variable size row and columns 
move, copy, sort, hide, resize rows and columns 
set font, size, fore/back color, face, alignment per cell 
cell margins, top/bottom & left/right 
drag cells in and between tables 
edit cells in place 
popup menus & check boxes 
draw boxes around multiple cells 
variable size grid lines 
PICT's and controls in cells 
“LDEF-like"’ custom drawing function 
greater than 32K data per table 
plus all List Manager functions and more 


More Info - http://www,teieportxom/-stack 

Demo - fip://ftp.telepoi1xom/pub/vendors/stack/SioneTableDemo.hcfx 


New Price 
New Version 


Rank Name 

Points 

Rank Name Points 

LMuiiter, Ernst 

"US 

ll.Antoniewicz, Andy 

24 

2. Gregg, X.in 

63 

12.Pk:a(>, Migue! Cruz 

21 

3. Cooper, Greg 

54 

13.Day, Mark 

20 

4*Lengyel, Eric 

40 

14.Higgins, Charles 

20 

5. Boring, Randy 

39 

IS.SIezak, Ken 

20 

6, Lewis, Peter 

37 

l6.Sruder, Thomas 

20 

7.Mallctt,Jeff 

30 

n.Gondrum, Eric 

15 

8. Murphy, ACC 

30 

18.Hari, Alan 

14 

9. Nicolle, ludovic 

28 

19.0’Coniior, Tudough 

14 

lO.Larsson, Gustav 

27 

20.Kaish, Bill 

12 


'ITiere are three ways to earn poinLs: (1) scoring in the top 5 
of any Challenge, (2) being the first person to find a hug in a 
published witting solution or, (3) lx?ing the first pcrstjn to 
suggest a Challenge that I use. The points you can win are: 

1st place.,..20 points 5Lh place.. 2 points 

2nd place.10 points finding bog..2 poinLs 

3rd place.,.7 points suggesting Challenge...2 points 

4th piace.,...,„4 points 

Here is Ernsfs winning solution: 

Disambigitatorxp 

(g) 1997 Ernst Munter 
r 

Prubktn suictnctiL 

(avert a list wtmls and a findSiriDg. GikI ^ imidiing woitfs which start with 
findString. FindString may cimuin wiki canb ? * and +. 


An initial izatiiin ntytinc can be used to build a private data structiire to speed up 
searching, 

nic LmUal word list may or may not be s<jrtcd, but catb generated malch list shoidd be 
sotted. 

SolutJim Strategy 


A string matdiing engine b needed lo evaluate words from the word list agaiast the 
find string 

In the simplest case, the match list can be created by comparing ^ach woid in die 
word Lbi with the find string, and then sorting match list, Thb h the procedure I use 
when there Is insuflicicni storage available {which may happen If the word list is very 
short). 

Wlien there Ls enough storage available, a private index is derived from the word list. 
This is based on word length as weU as bit maps rcpiesenilag ^‘i'bit “digests'* of words. 

On searching with a pajticula/ find string, only wr^rds of al least the known minimum 
length need bt* considcicd 

The fiml string is also represented with a digcst.The digest does not describe a wmd 
uniquely, and a final direa comparison U needed to confirm a word for the match list 
Rut the digest representation helps in rdtering out many words and groups of words 
quickly that need not be compared. 

Alphabetical sorting b done on each generated match List. 

Hit String Compare Engine 


There arc twci possibilitiE^^ 

■ findString coniain.s wild cards 
' or it does not 

If it does, stfir^ matching wdl be performed by a virtual maciilne executnig a very 
simple byte code program; however, if there arc no wild cards, an even simpJef 
comparison routine b used. 

In any case, the Parser fimction processes tJte input string (findString) into a program 
and an output string.The output string b simply the input string with wild cards 
removed. 

11ic first value tn the program b the minimum length of any string rcquifcd to match 
the original (irKlSiring.thc subsequent program bytes are fium the set of insuuaioiis 
-READ n read n chars without comparing 
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^ tor the Macintosh' 


The Industry Standard for 3D Graphics 

Port your code from other platforms with ease! 

^ Workstation Class Performance on your Mac 
Complete on-itne documentation and support 
^ All common support libraries provided 
Multi-processor capable 
UNIX or MKLinux versions 

^ Works with most compilers, including CodeWarrio/® 
^ Callable from C/ C++, Ada and FORTRAN 
^ Full Technical Support 
^ Custom Libraries available 

Conix Graphics 

wvirw.conix3d.com 
V Let your imagination fly! 


Sales Technical FAX 

800.577,5505 817.467.0461 817.467.9452 

sa les @ conix3d.com 

All trademarks ratnain the pmiitirty dI lhair rsspectivie ownare. 



- COMPF n compiirt- n char^i, 

on miMnuich t'xii with EAIL 
* 0)MPR ii eompaa- n diiu-.s, 

on (itismiich gti Irick (n-l) and rttr)' 

The program always ends with SUCCEED 

Special single b>'te forms of READ! and COMPn (ii<=7) optimize for cornttHm (t 
hfjpe), ami also ensure that the Ictigilv of the program is guaranteed not to exceed the 
kmgih of flntlSiring Since strlcnffuidString) Is known to he < 256. a fixetl amount of 
memory can be pitivided for die program cm the ClHI stack. 

Private Data Orgamzatlon 


All words id the cirigioal word list are ^presented grouped hi pages of 32 (max) words 
of equal length.Woals of length > 31 aa^ not diffcremiaicd and arc lumped in with 
pages of 51-char woals 

Each page eoiuaias pointers to 32 words, their individual word digests, and a 
summariidtig p;^ digest. 

WuaJ l>igest 


T\vo AZ-bit wortLs (2fl bits tiscd), one for single, the oUter for multiple chameter 
iK:euiTenc'cs in a Wf»a1. 

Digrsi-1 of a wordUsi word Is a 3Z-bit computer woaleadi hit ijidicaring the presence 
or not of a eharaetcr value in the wordUst word. 

Bits in ifigcst'2 aa* set only if 2 or more of a piiicular character occur in die wtJid. 

The lush function to cimvert a chameter mio a bit positiou is ubuiated in 
chatTable(1281 which maps alt legal chatacicrs into the tanjsc I to 28, The values tn 
ehatTablc arc rought)' in order of hequenc7 of ocourence of letters in an FjigJisb 
dirtionars' 

Hie digest for a fmd string is based on the noo-wild cards in the string, and iJms wth be 
a sub«set tif any match word maitbiog the fmd string. 


The example below shows an excerpt bom a topical page bswed on the dictiomuy' 1 
used for a word Use 

Each row represents the word digest for the referenced word at die end of die low. 
The last row Is the page digest, the biiOR of Ihc columns 

Note that for reasons explained bdow. storage of the w<ird digests is by column, that is 
die bits shown below am stored in 56 ulcmp^each column ^presenting the presence 
single or multiple, of a particular cluracter in aJl words of the page. 

‘ single - raoltlple 

qjxiikwvfybhjngpudclotratmie- QJ^Zmi-YBlMCPUDCLOTBANSIE 
oooonoaonoooooooiooooioiiiioGOOOOOOOOOOOOOOOOOOOOOOOioio 
Tunlsipii 

OOOOOOOOUOOOODODlOOOOlOllllOOOOOOOOOOOOaOOOOOOOOOOODOlOO 
US tains 

oaooooooooooiiooiooooiainioooooooooooooQooooQooocoooooo 

hinaanist 

OOOOOOOOOOOOOCOl10000101UlOOOOOOOQOOOOOOOOOOOOOOlOOOODO 
pantsuit 

OOOODOOOOOOOOOOl1000010111100000000000000000000000000100 

puiSHant 

10000000000000000100010111lOOOOOOOOOOOOOOOOOOOOOOOOO1000 
st3nd_in 

OOOOOOOOOOOOOOIOOIOOOIOUIIOOOODOOOOOOODOOOOOOOOOOOOIOOO 

standing 

OOOOOOOOO100000000100101 liiOOOOOOOOQOOOOOOOOOOOOQOOl 0000 
fanatics 

OOOOOOOOOOlOOOOOOOlOOlOUliOOOOOOOOOOOOOOaOQOOOOOlOOOOOO 

sanctity 

OOOOOOOOOllOOOOOOOlOOlOllliOOOOOOOOOOOOOOOOOOOOOOOODOOOO 

sanctify 

00000000000000100010010]11lOOOOOOOOOOOOOOOOOOOOODOOOOlOO 
castings 

000000000000001000100101111OOUOOOOOOOOOOOOOOOOOOO1DOOQOD 
seal Ling 

0000001000000010001001011IIOOOOOOOOOOOOOOOOOOOOOOOOOQOOO 
stacking 

OOOOOOOOOOOOIOIOOOIOOIO1UIOOOOOOOOOOOOOOOOOOOOOOOOOOOOD 
scathing 

OOODOOOOOOOOOODIOOIOOJOI11lOOOOOOOOOOOOOOOOOOOOOOOOlOOOO 
captains 

oooooooooooooooooiiooionnooooooooooooooooooooooooioooo 

antacids 

OOOOOOOOOOOODOOOOOOiOlOl 11100000000000000000000000000030 
initials 

00000000000000000001030111100000000000000000000100000100 

installs 

00000000000000000001010111lOOOODOOOOOOOOOOOOOOOOUOOlOOlO 
Italians 

0000000001OOOOOOOOO10101nIOOOOOOOOOOOOOOOOOOOOOOOOOOOlO 
finalist 

000000000010000(30001010111100000000000000000000000000010 

salinity 

OOOOOOOOOOOOOOlOOOOlOlOnilOOOOOOOOOOOOOOOOOOOOOOOOO1000 
slanting 

OOOOOOOOOOOOOOlOOOOlOlOnnOOOOOOOGOOOOOOOOOOOOlOOOOOOOO 

stalling 

OOOOOOOOOOOOOOlOOOOlOlOllllOOOOOOOOOOOOOOOOOOOOOOOOOOOlO 

tailings 

ooooooioooooooicoooioioniiooooooooooooooooooooooooooooo 

stalking 

0000000000010010000101011IIODOOOOOOOOOOOOOOOOQOOOOOOODOD 
blasting 

OOOOOOOOOOOIOOIOOOOIOIOI1 nOOOOOOOOOOOOOOOOOOOOOOOOOOOOD 
stabling 

oooonooooooooooioooioioini 000000000000000000000000000 lo 

tailsplii 

000000000000001100010101niOOOOOOOOOOOOOOOOOOOOOQOOOOODO 
stapling 

OOOOOOOOOOOlOOOOlOOlOlOn1100000000000000000000000000000 
Istanbul 

OOOOOOOOOOOOOOlOlOOlOlOinlOOOOOOOOOOOOOOOOOOOOOOOOOOOOO 
saluting 

00000000000000011001010111100000000000000000000000000000 
nijpt ial s 
page digest; 

1000001001 nil 1111110101 UlOOOOOOOOOOOOOOOOOOOOlOlOlll 10 
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MoPC asHiEbting the words into psgps.a private tempomry word list is buill, sorted 
on digest I. Iliis ^ups wonLs of similar digests into a page, resulting in sparso; more 
cCfecUve Wt pattcnis for die page digiests 

Word Fiitcfing 


To Tmd matching words wti use the page intk* to skip past all pages coniaining words 
of less than the minimiim length. 

The pgc index scan then pmvkicsa fast screening fiinetion by comparing tlic find 
digest with caeh |>age digest (a copy of which exists in the index entr>')- 

Once a promising page is ide mined on die basis of its digest Jt is scanned to find 
matching words. 

The findSirlng gtmerates a signature, a string of unique hash values of Uie ongiiial 
findString.To scan the digest bits In a page tor a particubr findString, the signature 
values are used to seJeei ailumns of bits. Tliese are accumulated (bitwise AM)). 7lie 
resulting 52 bii value idciuifies, by l-blt jKJsitttms, the words maiehing the IlndString as 
far as digests go. Tlie aeeimiulaUon of columns is aixindoned as sotyn as the 
accumulator reals 0, indicating that no words on Uie page will match. 

If the accumulator pattern is not t). one or several words may be indicated^ but sliey 
still need to be confirmed with the alpha^mimerkal string matcher before being added 
to the match List. 

Sortirtg 

Sorting of the final match list is done using a form of HeapSon, split into its iwo 
components, huilding of the priority queue (my routiiK: SokIO) and down sifting (my 
rnotine SonQ)- 

Special Cases 


If findSLTing contains ONLY wild cards, there is no need to matdi any words except fi>r 
length. Since word pages are already organisurd by word length, it remains to send all 
words from all pages of the minimuni length given by findString (the number of'+' and 
symbol.s). 

Optimb^tions 

When there are mt wiki curds in findString, a simpler and fester alphaniimeric 
comparison is used. 

The pagelntlcx entries comaui a copy of the page digest! This avoids memory- jurcess 
to many pages which evidentJy coniam no mateliiug wottis, 

The hash ftinaion is chosen to represent character frequency in order to cluster words 
in pages more optimally This feature relies on presorting the private word list 
accordingly Tlic program will work correctly if this sort is turned off, resulting in faster 
Lniiialization, t>ut slower matches. 

In my- tests, presorting paid off. 

There is some attunint of code replication for expediency, notably ihcTC are two 
ciLstomiml copies of heap sort, and two vetsions of generating word digests. These 
could probably- avoided without a great loss of speed 

A final optimization is the way word signatures are consin]cted.Thc!ie arc derived ftom 
findStriiig and used to scan the columns in the page bit maps. Rather than convert the 
find^lring alpbanum cliaractcrs to sigmitiire charaaers (mnge 1-56) in the order of 
oeeurrence in findSuing, wc arrange it so the rarest characters are tested first. 


MkLinu 

Microkernel Linux for the Power Macintosh 

Why wait for Rhapsody? MkLinux is a compiett? system, 
based on 1 ,iaux 2 and the Mach 3 microkernel. It includes a 
complete software development system (gcc, gdb, perl,...), 
XI1 R6.3, and hundreds of other commands. Get MkLinux 
and start working right now with Mach, Objcctivc’^ll, UNIX 
development loois, and more,„ 

MkLinux builds and runs most Intel-based Linux sr^ftware. 
It works efficiently and reliably on a wide range of Power 
MacinUtsh platforms, with other ports on the way. MkLinux 
has an active user community and a substantial Reference 
Release, both sponsored by Apple Computer. If you want to 
get a jump start on Rhapsody, this is a great way to do it! 

Visit Apple's MkLinux web site (www.mklinux.applexom) 
and Prime Time Freeware's web site {www.ptf.com) to find 
out mure about MkLinux and other fine freeware products. 

Prime Time Freeware info^iiptf.com 

370 A1 tai r Way, #150 (4t)H) 433-y662 

Sunnyvale, CA 94086 (408) 433-0727 fax 


void InltDlsambiguatorf 

const chnt *const vordLlstlj, 
ulotig muaWords, 
void ‘prIvStorage. 
ulong storagf^Sl xfi 

); 

ulong /*nuniMaichV Disanbiguaiorf 
const char ‘const worAisttJ* 
ulong numWordSp 
void *privStorage. 
tilong storageSiES* 
char *finciStrlng, 
const chat ^matchl.i st [J 

); 


/* words to match against V 
/* number of words Ut woidlisi 7 
r priva^tc storage preinitklisscd to rcio V 
r number of bytes of privSioiagi: 7 


r words (o match a^inst 7 
/* number of words in wordlisi 7 
/• pfiv^nc storage 7 
r number of hylcs of pri^'J^orage 7 
f* siring lo match .includes wild cards 7 
/* return maidicd words here V 


Assumptions 

All word.s.and findString arc < 2S6 characters long. 

'Fhcre are no zero length wotdLs in woidtJst. 

Ilie absolulc niinimuiu anui uni of private storage: -1 bytcs.Tbis ensures that nort- 
initialization of itie tables cajv be determined. In this mode, a sequential scan of 
w'ordList is made. 

For optimal operatkMi. memory available for private data should be at kasi 256 bytes + 
abot it 1 ^ bytes per word The exact amount t>f siorage needed depends on Itic length 
distributkm of the wonts in word list, 

FindStrit^ will be nxMlificd by- Pisambigiiator. 

Static memof)' of bytes is used for lookup tables. 

7 

typedef imfllptid long ulong; 


# inc iude <stdlib.h> //It seems unnecessary to mention 
^include <atring .h> // tiiesc with CW Pro 

//NOTF: 

// Program Tuning Option 

//Turning SOftTWORfHNDEX off reduces inftializatkm lime 
// 10 1/3 but increases search time by 50 to 8054 

//n>c best selling depends on dictionary, findString fatterres 
// and die number of searches in a test run. 

(define SORTWORDINDEX 1 

typedef unsigned char Opcode; 

//‘const dw' is used a lot. 

^define CCC const char 


Prototypes 

sufltic int Parse (char' spec . Opcode progriini []); 
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static ifit SimpleMatchCCCC* x,char* spec.int minLert); 
static iat VHMatchtCCC* x.char* spec.Opcode* program): 
static Int CompCCCC’ ap.CCC* Pp]: 
static ulong HakeSubMgest ( 

CCC* xString.ulong* dit2,char slgOJj 
static void Soct{CCC* inatchList y .long numMatciO ; 
static void Send(CCC* matchList [] ,CCC* vp»ulong tiumHatch): 


//The table l-SB siorcs the pasitkH] of the least 
// significant Tbit in a byte (range 1 to 8), 

//a zCTcybytc PCpom 0, 

//This tabic Is built frum nested ^defines 

^define T1 1 

#define n T1.2,TI 

^define T3 T2*3.T2 

^define T4 T3»4.T3 

tfdefine T5 T4.5.T4 

#define T6 T5.b.t3 

#define 17 T6,7.T6 

Ifdefine T8 T7,e.T7 

static char LSBi256]“IO,Tah 

// MISMATCH takes cam of case insensiTive niatchiug 
//define MISMATCH{a.b) ((a^bnOxDFj 

^define HIN{a.b) (a<b7a:b) 

// HASH is jusi slionhand for charlable. 

//define HASHCc) (charTab]o[cl) 

// Maximurti length of strings 
tfdefitie MAJLLEN 256 

const enum 1 //cumpr must be last 

SOCCEEIW} * FAIL.RETRY.READ.HEADl,COHPF.COHPR-COMPF+S); 


Eoa t chLen= * ++p gm: 

for {l^OiiXinatchLeii;!^^-) { 

^ if (MiSHATCHt*++X.*+fspec)) goto retry: 

break: 

retry: 

// this mysterknis retry after muvnaich takes care of 
//■‘xPy^to find word 'xxay*^ matching the second x 

If (CEavePC”=0) ( I tO™iiiargin“) J return op: 
pgifl-’SavePC -1: 
x-^aveX+1; 
spec-savaSpec: 
break: 
case COMPR+7: 
case COMPR+6: 
case COHPR+5: 
case COHPR+4: 
case COMFR-t-3; 
case COHPR+2: 
case GOMPR+l: 

savePC^pgm: 

matchLen=op ^ COMPR; 

goto try_again: 
case COHFR: 

savePC^pgra: 

me t chL en= * "H-pgiD ; 
try_again: 

for ti-l:i<^atchLen:l-H-) I 

if {HISMATCHfK[lLspEe[i]n I 
if (margin-) t 
++x: 

goto try_agalfi; 

I 

return op; 

1 

1 

saveX^x: 

savespec=spec: 
x+“iiiatchLen: 
spec+^atchlen; 
break; 
case READ: 

x+=*+tpgni: 
break: 
case lEADl: 
t+x; 
break: 
default: 

return op: 

) 

1 

1 


Static ;iUocatio[ts 

// chatTable serves double duty 

// in parsings it helps scpainic wild cards. 

// in tfigest fonning, it provides a sort order 
static char charTablefUR] “ 1 
0 , 0 , 0 , 0 * 0 , 0 . 0 , 0 , 0 , 0 , 0 . 0 . 0 . 0 * 0 , 0 * 

0. 0. 0, 0, C, 0. 0, 0, 0* 0. 0, 0. 0. 0* 0, 0. 

2, 0, 0. 0, 0* 0. 0* 0* 0, 0. 0, 0. 0. 0» a- 0* 

1. 2, 3. 4, 5, 6. 7, B* 9,10. 0. 0. 0, 0, 0, 0. 

0.25,12.19.18.28.10,16,13.27. 4. 7.20,14,23*21, 

15. 3,24,26.22.17, 9. 8, 5,11, 6, 0. 0, 0. 0, 1, 
0.25,12.19.18.28.10.16,13,27, 4. 7,20,14.23.21, 

15. 3,24,26.22.17, 9. 8. 5,11, 6. 0, 0. 0. 0. 0 
h 


static Int VMHatchCCCC* K,int sle[i,char* spec.Opcode* 
program) | 

//Virtual machine interpreter, 

//VMMaich cxccuics“pr'^Si^“''viiti tlic help of 
// “spec* to determine if sirir^ "x" matdies. 
int fflargin=alen‘*program: 
if (margin<0) return FAIL: 

CCC* saveXi 
char* saveSpec: 

Opcode* savePG*“0; 

Opcode * pgin“prograffl; 

InI matchLen.i: 


x-;spec-: 
for (:;) f 

Ope ode op-''^+pgm: 
svltch (op) \ 
ease StJCCKHD: 
case FAIL: 


return op; 
case COHPF+7r if 
case COHPF+6: if 
case COKPF+5: if 
case COHPF+4: tf 
case COMPF+3: if 
case COHPF+2: if 
case COKPF+l: if 
break: 
case COMPF; 


(KiSHATCHt *+tx, *++spec)) 
(MlSKATCH(*t+x.*++spec)) 
(HISHATCHl*++x. *++spec) 1 
(HTSHATCHi *++x. *'H-Bpec) 3 
(MISHATCil {*++x. *++spec)) 
(HlSMATca(*++x.*++spec)) 
iHlSMATCH{*4HTt. •-H-speeJ) 


goto retry: 
goto retry; 
goto retry: 
goto retry: 
goto retry: 
goto retry; 
goto retry; 


VMMjitdi 


//The class Wordtndex holds a pointer to a woid from 
// wordList and computes digests and signal Lite for it, 
struct Wordltidex ( 
ulong digestl; 

CCC* word; 

void InitfCCC* wordx) I 
CCG* wp“wordx; 
int s=HASKf*wp): 
ulong dlgl^lL<<s: 
for (::) ( 
int c: 

if (0^(c="*++vp)) break; 
s“HASHCc): 
ulong bit“lL<<s: 
digl 1= bit: 

digestl”digi: 
wotd^wordxT 

1 

ulong MultiDigest(char* slg) I 
// Returns digest2 for the word, 

// and ainipums its stguamre 
CCC* wp*Mord; 
int s-MASH(word tO]); 
ulong digest2-0; 
ulong digl-lL«s: 
sig[0]“s: 


Wordlodcx 
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Mac, go out and touch the world 

ADB f/0 kls yf)ur customeri^' Macs control things, it fats them 
I ADB f/0 lets the Mac tx^ part of Iht: physical world. 

Thousands of Uses 

Sfjena^, Mullifiieriiai Children's Museems, Home Automation^ 

Theatre Stages, liKiusIrtal Tt^slirg, Mcxiicat Research, Bonsai 
Watering, Robotics. Weather Stations—anything I hat c^in 
be etectroofcally measured or oontrolled can use the ADB I/O. 

No Serial Ports Occupied 

ADB I/O uses the App^e Desktop Bus to communicate inputs and 
outputs to and from your Macintosh. (Maximum polling frequency 
is 90 Hz.) No externa] power supply is needed. 

Eight 1/0 Channels Provided 
hour rdays tor output hour channels tor Digital In, 

Digital Out or S-bit Analog In 

Extensive Software Support 
With ADB I/O and nearly any environment ‘ 
it is easy to build customized 
applic-ations tor your control ar>d 
data acquisition needs. 

For more info, vtsil us at 
www^bxzzzxx.coin, 


for {:;) I 
int c; 

if (fl={r=Miwp)) br0ak: 
s-tlASH(c): 
ulotig biL=lL<<s: 
if (0=tdigl ^ bit)) I 

''H-sig=s; 

digl T= bit; 

I else if (0=(dioest2 & bit)) I 
*Htiig=3\2Si 
di£erxt2 1“ bit: 

1 

1 

return digesiZ: 

} 

int CompDigeSt{WordIndex wx) I 
return (wx.digest1)-(digestl); 

I 

1 : 


// 'lilt ctm Pagt bokJii pomters lo 32 words from wordlist 
// which arc of the .same length (wonlit >= 31 iogtiher). 

// Page also contains Ixjth word digests for cadi wimU, 

// in the bits[] array, stored In signature oriented columns. 
//A pagt' providt^ string matching for the 32 Wiirds it owns, 
struct bagel 

CCC* word [32]^ 

charlen[32j : 
int fill: 

Page* next; 
ulang pngcBigenr1: 

// uJong pageDigestl; ovedi)^ on unused bltsfhl 
^define pageDigest2 bits[0] 
ulong hits[Syj : 

void InitlPage* following) f 
// clears all and sets iuibige. 


// memory may already' be prectoared, but not necessarily 
// since pages may overlay tbe temporary wordlntlcx 
memsei [this,O..5iacof(Page)) t 
next=f oilowln g: 

} 

int IsFullO (return (fill>-32):l 

void Add(Wordlndex* wip.int length) f 
// AtUls one word to a p^, 

// ORs the w'ord dig<^sts into the page digests, 

// Also ORs die horizontal bit slice representing word digests 
// into the bits array 
char sigl64j: 
ulong curbit=lL«fill: 

Ion [f in]=lengi:b: 
wordLf ill++]”w1 p ->word: 
pagebigesLl ]■" wip■ >d 1 gOiSt. 1: 
pageDigest2 |= vip ^MulLlDigcst(stg): 
int c: 

char* sigp-sig; 
while (0 ! = (c=* sigp-Hh)) f 
bitsfe] 1= curbit; 

] 

1 

ulong Match(char sig[]} 

//Accumulates vertical bit slices Irooi a given signature 
// Returns a bit map of likely otKlidalc words 

I 

int c^sigTOl ; 
ulong acc“bi t^;tel: 

while ((acc) (0 f“ (c=*-H-nig))) { 
acc &= bits[c]: 

I 

return acc; 

] 
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ulon^ SendSelectiQnVKC 
ulong acc» 
char* fiudString, 

Opcode program[], 

CCC* BiatchLlstfl . 
ulong rtUraMatch) 

I 

// Uses the "acc” bitmap to identify words for fiill 

// string matching, and scikIs maidiLng words to the matchljsL 

// Uses tlic LSB array to quickty isolate bits in acc. 

CCC** wp=^ord'l: 
char* lenp=len-l: 
do I 

ulong accLo^'acc & OxFF: 
if (accLo) [ 

itit j=LSB[accLciJ i 
acc>>=j: 
wp+=j; lenp-t=j; 

if (SUCCEED=VMHatch{ *wp. *lenp. findString. program)} 
Send (matchList, ’wp. nuDiMatch++) i 
] else { 
ace>>”B s 

wp+=8; 

] 

I while (acc): 
return numMatch: 

) 

ulong SendSelection( 
ulong acc* 
char* findString. 

Opcode program[]» 

CCC* matchListfl- 
ulong numMatch) 

I 

// Same as SendSeketionVM^ but uses simpler string tuaiching 
CCC** wp=word-l: 
int minLen=prograra[Oj; 
do ( 

ulong accLo=acc i OxFF: 
if (acclo) I 

int j=LSlJUceLoJ; 
acc>>=]; 
wp+=j: 

if (SUCCEEI}=SiinpleMatch (*wp, f indString,minLen]) 
Send (match Li St, *wp, numUatch-H-); 

\ else I 
acc»=8t 
wp+^8: 

I 

1 while (acc): 
return numMatch: 

) 

ulong SendAllCCCC* matchList[].ulong numMatch) I 
// Sends all words on ixj|^ to matchlisi 
for tint i=tJ :i<fili:i++) 

Send (inatchLiSt .word [i] . numMatch-H-): 
return nuinKatch: 

1 

1 : 


Pagelndex 

// The class Pageindex contains a [Jointer to a page, and 
// keeps a copy of the page digest L 
// During the scan, Fageljidex provides a screening funai(jn 
// to eliminate unnecessary page accesses k digest] can 
// aheady rule out all words on a pge. 

Etruct PageIndex t 
ulong digest!: 

Pago* page: 

void lnit(Page* thePage) \ 
digestl“thePage->pageDigcstl; 
page^thePage; 

J 

Page* Screen(ulong flndDigestl,ulong fintiDigest2j I 
If ((FindDigestl (findDigestl Ik digestl))) 
return 0; 
return page: 

I 

1 : 


PrjvateDaia 

//The class PrrvateData is the main structure mapped into the 
// private memory space allocated on the heap. 

//hie pagcGrotipfl array holds poiniers to liiied hsts of 
// pages, according to wotd leagUi. 

// Once all pages are assembled, the page addresses are remapped 
// inhj a linear page index, sorted by ascending word length 
//The indexOrtJupli] array pennts to the the first page of each 
// group of pages of a given word length 1. 
struct PrivateDatn t 
// Page* ncKtPagc; overlay on unused pa^GroupfO) 

#defiiie nextPage pageGroupfO] 

Page* pageGroup[32]; 

// Rigclndcx* cndOfPagcIndex: overlay on indcxGmup[0] 
idefine endOfPagelndex IndexGroup[0] 

Pagelndex* IndexGroup[32]: 
int bottom[Ij : 

void Init[ 

CCC * const wordListfl, 
ulong numWords. 
ulong etorageSize) 

I 

// Must have at least tills much storage to build minimal 
// page index sj-stem 

ulong mnimumStorage=* 
sizeof(pageGroup) t 
sizeof(indexGroup) + 
numWords'alzeof(Wordindex) P 
sizeof(Pagelndex) + 
sizeof(Page): 

if t£torageSize<miniiDumStorage) [ 
nextPage=0: 
return; 


#lf SORTWOKDINBEX 

// B\dJd priority queue of wort! index items 

// This is the insenion step of heap sort 

Wordlndex* wordIndexList=(WordIndex*)bottoin: 
int i,j,n; 

for (n=0 ;n<numWotds :n-H-} ( 

WordIndex wx; 
wx.Tnit(wordList[n]); 

Wo rdindex * base=wordIndexList -1: 

Wordlndex z: 
i-n+1.f“i>>l ■ 

while { (p0)4&[wx.CorapDigest (z=baEe[ j] )>0)) ( 
base [1 ] : 

i=j:j=0>l: 

1 

base[i]=wx: 

} 

// Unload priority queue, step 2 of heap sort 

nextPage=[Page*)this + storageSize/sizeof(Page) - 1: 
Wordlndex* wip; 

Wordlndex* base"wordIridcxList -1: 

Wordlndex x: 

ulong numUnsorted^numWorde: 
wipr^base+numUn so rtedil: 
if [numtfnsorted>l) do I 
i=l:j-2; 

x=baEe [tiuitiUnsorted-j ; 

*( wlp) = base[1]; 
if (nm!iUnsorted<=l) ( 
basellj=x: 
break: 

1 

while (j<=nutiiIJnsorted) I 
if {(j<numUnsortod) 

(base[J] .CompDigest (base [ j^^lj )<0)) 

j++: 

if (xXonipDigest(base [j]) >-0) 
break: 

base[i]=base[jl: 

I 

base[ij=x; 

] while(1); 

#elee 
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// No sorting, just copy ami initiaJkc woftl indot 
//10 whatever order w(»rdLisi isi in. 

//This nediiecs Initialh^tiori time at the citpenjit 
// of seaith cffidcnt7 ba'aose more pajses will 
// luve 10 lx; liliaicd 

Wordl ndex * vo rdlndexLis t=(Word index * )bo t L ob : 
itit n: 

for {n*H):n<nuaWords:n++) 

wnrdTndoxL!st(Dl.lQit(wordLiEt[nj)j 

Wordlndex* wip; 

#endif 

// tJnlaad word index and build pa^s in linked lists 
// based on word knt;tb 

^PXtP^^ge-(PAge•3thie + storageSize/slzeof(PaBe) - 1: 
wlp^'wordTndcxLl ftt+miiuWordP; 
while (wip>wordIndex!,Ist) I 
Mlp-: 

if (0=lnaertWordlnPaBi*(wip)) returns 
J 

// Map linked lisL<i to a linear index of pages by Jengdi 
If {C--ByndTndexC)> I 
next Pa go«NULL: // not enough storage 

return! 

1 

I 

fnt lnxnrTWordInPage(WordIndex* vip) I 
// Inserts one wind in a paj?c. opens a tiew pajjc if 
// none exists or if the current page b* full, 
int len=strlen(wlp >word)i 
if (ien=t)) return 1: // igiKjft (J^lcngth words 

int cutLenHlIN (31 * ien); 

Page* page^-pageGfOUplcntLenJ: 
if ((page“03 II (page >IsYuilE5)) I 
Page* temp-page; 
pugc^next Pago ; 

// test if tile ht>ttam of the gniwing page arra)- etilUdes 
if with ihc top ijf the shrinking woitl index array 
if (page <- (Page*3wip) f 
// not enough storage, we have lo Ixiil out 
n^xtPage-HULL: 
return 0: 

1 

page->lull(temp); 

pageCroup[cutLen]: 

I 

page'>Add(wip«len); 
return 1; 

I 

Fageindex* »uildlndex{) I 
// Builds the page index, starting at this->hottcHn, 

// overwriting sionige previously used by word index. 

Pagelndax* pi-(Pagelndex*)bottoi]: 

P ageIndex* p iTop-(Pa geIndex *)next P age; 
for (int len-l;lenC32;l€n++3 ( 

Pa ge * pa ge"pa geG r o up 11 en 1; 
lndexGrouplien]*pl: 
while (page) ( 

if Epi>piTop3 return Or 
pi++->Init(page): 
page^pageOnext; 

I 

] 

return (endOfPagcTndex^pI); 

1 

// Use nextl^^-' as a flag to itnlicatc if we initialized 
// nextPajse will be NUti if we mi out of siorngc during 
// ihe initialization. 

void* TaTnlrialIxedO [return nextPage;! 

ulong SendAllCCCC* naichLlatEJ .ulong miuLen) I 
// Sends aJ] words >- niitiunum Icbeth from aJ! pages 
ulong nuinMaicb=0: 

for (int ien*MlHE31 ,miuLen) :len<32;len++) t 
Pa ge * pa ge'^^pa geC r oup 11 en J; 


while (page) [ 

nuraKatch^page->SendAll (laatchLlst *nuiiiMatch): 
pa gc^page >next; 

I 

1 

return numHatch: 

* 

ulong Colle£‘tVM( 
char* findstring, 

CCC* matcliList [], 

Opcode program []J 

[ 

// CiolketVM iicans all pages above die minimum length, 

// itiatchcs using the virtml machine string mateher, 

// and sends matched woFd.s into matchUst 
char sig{64]; 
ulong findDigesL2; 
ulong 

findDlgeatl^akeSubDigest £findString. ifIndDigea t2, sig); 
ulong numMatch-O: 

Pagetndex* pl=indexGroup [HIN (31, prograialO])); 
for (!p! <endOf Page Index ipi'HfJ f 

Page* page"pi >Screen(flndDlgestl,findDigest2): 
If (page) I 

ulong acc=page >Ha Lch(sig); 
if (acc) nujiiMatch=^age >SendSeleut;lonVM( 
acc * findString, program. marchList, numMateb): 

J 

) 

return nniuKutch; 


ulong Collect( 
char* findString. 

CCC* matchLlstfl , 

Opeodn programfl) 
i 

// CoUcct is similar to QillecfVM but uses the simpler 
// string matdiing hincdon. 
char sig[b4l; 
ulong findDigest2: 
ulong 

f 1 ndDignat l=MakeSubDigest (findString,indDigestZ♦ sig); 
ulong nuniKati::h=0; 

Pageludex* pi*indcxGroupEMTN(3l,programlOl)1 ; 
for (rpi<eiidOfPageIndex;pI'H-) I 

Page* page=pl*>Screen(fiuiiDlgestl, find Digests); 
if (page) I 

ulong acc=page‘>Match(sig); 

if (acc) nunil!atch“page->SendSelection( 

acc,fIndString,program*matchLiSt,nuinMatch): 

I 

1 

return numHatch; 

I 

h 


hiiiDisambtguator 

void InitDlsajnbigualorl 

// InitDlsambigiiPtor to be caUetl from the application 
CCC 'const wordList[]t 
ulong nuraWords, 
void *privStorage. 
ulong ntorageSize 

) I 

// Just sets up the private <b»ta sliaieture 

PrlvateDa tu * PD^ (Prl va teQnta *) p r 1 vS tore ge: 

PD - > Init (wordList, numWorcis»s I otageSixc); 


Lhsambiguator 

ulong D3Kambiguatorf 
// Disambiguator to be caflo] from the application 
CCC * const wordListU, 
ulong numWords, 
void *privStorage* 
ulong StorageSize * 
char 'findString, 

CCC 'matchliatfl 

) I 

Friva teDa La* Pl)= (P rlvateData *) pr 1 vSto ra ge : 
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// AJItKates space for ttie loQgest possible VM program on 
// the stack and parses find string 
Opcode program[HAX_LEHj; 
int useVM=Parse (t’indString. program); 

// findstring is now stripped of wildcards 
ulong numMateh: 

if (PD->Islnitialiaed()) i 
// should always be true except 

if ((^findString) || [program[0]>31)) \ 

// Normal findblring witli alphanum characters 
// or wildcards only, but minLength > 31 

if (useVK) I 

// wild cards detected, must use VM matching 

numMatch^PD >CollectVM(findString,raatchList,program): 

I else I 

// no wild cards, can use faster simple matching fonctiem 

nuinMateh=PD-)Col lect (f i ndStrlng, tnatchList»program); 

J 

] else f 

// No charactas to match, minimum Jenglli <=31 
// we can simply send all >= minimum length 

nmnMatch"PD->SendAll (matchLiat, program [0]) ; 

) 

\ elae ] 

// if we get here, PD was not initialized, and wc have to 
// just scan the entlte word list for matches 
// We don’t really expea to get here except with 
// extremely short word listii. 
nu.niMatch=0: 

if ({‘’findstring) I I Cprogrotn[0] >31)) I 
If (iiseVH) { 

Cor (ulong i=0;±<nujBWordB;i++) 
if (SUCCE£D= 

VMatch{vordList [i] ,strlen(wordList [1]), 
findString,program)) 

Send(matchLlst.wordList[i],nymMatch ++)\ 

1 else I 

for (ulong i"0; i<iiumWords;i++) 
if (SUCGKED= 

SitnpleNatchCwordList lij , findString, program fOl)) 
SendCmatchList ,wordLiEt (il ^numHatch-H'): 

1 

] else I 

for (ulong i=0 E iCniunWordij^i++) 

if (strlen(wordfist[i]) prograralOj) 

Send (matchijist iWordList [i] * *numHatch'H') ] 

) 

] 

// Final sort (step 2 of heap sort) for match list 
Sort(matchList,nmriMatch): 
return nunvMatch; 

) 


SimpleMateh 

static int SimpleMateh[ 

CCC* 

ehat* flndStrlng, 
int minlen) I 

// alphanumeric matdie of x against HndString, 

// no wild cards allowed 
X : findstring-^: 
for (int i=0:i<minLen:l’H-) f 

if [MISMATCH{*+^,*-H-findString)) return FATL: 

I 

return SUCCEEDe 
I 


Send 

static void Send( 

// Inserts word wp in matchlist as a priority' queue 
// Ln preparation for sorting later 

CCC* m.atchList[K 
CCC‘ vp, 

ulong numMetch) I 
CCC** base“matchList-lE 
CCC zi 

long i”numMatch+i,j=i»1; 


while ([j>0)E&Comp(vp,x=hase[J] )>n3 I 
ba£efll“zE 
i=jE 

1 

base[i]=wp; 


Comp 

static int Comp(CCC* ap,CCC* bp) 1 
//Alphabetic case insensitive string comparator 
char a^*op; 
if (a) do [ 
char b=*bp: 
if (HISMATClKa.b)) f 

return (a | 0x20) - [b | 0x20); 

a=*f+ap; 
bp+f E 

j while Ca): 
return -1; 


Parse 

static Int Parse (char*’ flndStrlng, Opcode program []) 1 
// Scans the findString and creates a bytecode program, 

// All wild cards arc stripped from findString. 

// program fOl contains the mininiutn laigth of words to matdi, 

// the test of programl] contains tokens from the enum set. 

// Returns the number of wild cards remtjvcd from findString. 

^define EMITCxJ l*++pgm=x:I 
Opcode* pglii=progr 3 m; 
char* nGwFindStrlng=rindString; 
int onFailure=MiL E 
char c^*findString: 
int n,niinLen“0,usesWiid“OE 
for (::) I 

if (0=charTablerc]) 
awltt'.h(c) ( 
case : 

i3=D ; 

do !n++:l while (‘7' = (c=*++findStrlTig)): 
if (n—1) EMIT(RMDl) else I 
EMIT(READ); 

EMlKn): 

I 

inlnien+=nt 

uaeaWild-H-; 

br^ak; 
case : 

minLen++; 

EMIT(READl): 
case ‘‘: 

ihdString: 
onfallure“RETRY: 
usesWild^+E 
break: 
default: 

EMIT(SUCCEED); 

* jiewFi ndSt r iiig=0: ///efo terminate the new FindString 
program [0]-mi nLen: 
return usesWlld: 

1 else f 
n=0; 
do f 

n-H-; 

•newFindStringf+=c ; // copy non-wilds to new string 
J while (charTable ic“‘+-^findSUingJ ] T 
if (FATL--onFailure) I 

if {n<-7} EMlT(COMFF+n) else { 

EMIT(CQMPF); 

EHIT(n): 

f 

I else I 

If {n<-7) KMTT(CaW?R+n) else ( 

EMITfCOMPRj: 

EMIT(n); 

] 

t 

onFaiiure-FAIL; 
mlnLen+“n; 

1 

) 

] 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech’’ Magazine and 
Apple’s develop™ issues 1-29! 


... in THINK Reference fonnaU 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech” CD-ROM. 

• Almosi 1600 articles from all 139 issues of 
MacTcch Magazine (1984-1996) 

• Includes Apple develop issues 1-29 

• Improved hypertext, improved indices, and a new THINK 
Reference Viewer — for lightning quick access! 

• New hyperlinks between articles 



• 100-1- MB of somce code — use them in your applications, with no royalties! 

• Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-Vl 

• 8()MB of FrameWorks/SFA archives and the most complete set of Frameworks 
archives known 


• Sprocket***! MacTech's tiny framework that compiles quickly and supports 
System 7.5 features 

• The best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 

• Popular tools that Mac programmers use to increase their productivity and 
much more! 



Web Site: http//www.dcvdepot.coin • E-mail: orders@devdepot.com 

Phone: 800-MACDEV-l • Outside the U.S. & Canada: 805-494-9797 • Fax: 805494-9798 


MacTech is a registered Irademark of Xptain Corporation. MacDev-l4 THINK Reference, Developer Depot, Sprocket, JawaTecit, WebTech, BeTech, and the MacTulorMan 
am trademarks of Xplain Corporation. Other trademarks and copyrights appearing in this printing or software remain the property of their respective holders. 







MakcSubDigc^i 


static ulocg HakeSubDigaet{ 

CCC* xString, 
ulong* dig2, 

char slgll) I 

if a pair of word di^^sts and a sigoaiurc (rom 

// rtndStrifig No duplicate slgoaiurc dianctcnr. 

Int s^HASB£xString[OJ): 
ulong digestl=lX.<<si 
ulong multiH): 
for t;:) I 
lot c: 

if £0=fc=*+txStritig3) break; 
j5-HASHCc) : 
ulong Mt=lL«s: 

If £0^(diEestl h bit)) 1 
digestl ]“ bit; 

) else [ 

If (0“(miiltl i bit)) 1 
multi 1= bit; 

I 

J 

1 

// Make iIk: Mgjiamrc in bit onkr, that m with the 
// Ic^ frequent finglhih letters first, so that page 
// scatuung will fad as soon as possible if no word 
// ki the page will match, 
ulong bitl=2*biL2=2; 
ulong K!r!gle=dlgestl if (-multi); 

Inc sl>s2: 

//Test rarest letter combinations first 
if tmulti) I 

for £s2=29;s2<”56;s2++) I 

if (multi h bit2) 'sig+^sZ; 
bit2 +- bit2; 

1 

1 


fktrt 

atatlc void Sort(CCC' matchListU♦long numMatcb) I 
// Hop sort step 2, used for final sorting of tlte 
// match list. 

CCC** sLiEt"“inatchLlst’l; 

CCC* x; 
int 1.j; 

CCC * * b^sL i St +n u niHa t ch+1; 
if (numMatch)!) do t 

x*sList [iiuniliatch-j: 

•(^b) ” sListLlJ; 
if (numHatch<-l) t 
sList [ll^; 
break; 

while (J<“numMatch) [ 

if ({j<TiumMatch} 

(CompisLiat [jl. sLiat [|+1] )<€)) 
j’H-: 

if (Comp(x♦sLlSt[j])>“0) 
break: 

sList [1] “sT.Is t[j]: 

1 

sList[i]=x; 

\ whlleCl): 

I 


for {al“l:al<-2fi:aI++3 i 

if (single & bitl) *slg++=gi; 
bltl 4- bitl; 

I 

•sig++-^0: 

’dig2=iQulti; 
return digestl; 


Visit MacTech" Magazine’s Web site! 

http://www.mactech.com 


Help Make MacTech Work 


lire at MacTech Magazifie, wt; Rtly heavily on 
outside writers for mast of tlie material that 
appeufs in our pages. If readers did not 
pitriiciputc in die mag^tzine, .sending os iheir 
ideas and taking the time to write articU^s, tliea- 
would be no Mac7'eck MacTech M£^^ne is 
not a staff of wriicis sending a constant stieani 
of one-way messitges outwards; iC'.s a livings 
evolving network of^ ncadeis conversing with 
one anotlien educating one anodien sharing 
their knowledge, tlK*irexfX'i1cnct% their interest, 
their trials and irihulations and foys and 
successes in tlie constantly unfolding story of 
programming the Maciniash, Mciclech 
Magazine doesn't jiLst haf>pen: ifs what the 
community makes it. Tf we carry lepofis of 
future trends and technologies, if we leach 


usehil methexLs, if we revkw new lxx>ks and 
tools, if we pn jvt^e ihougliL, provide help, ride 
die wave of ainenf interests and concerns, it Ls 
only becuLse we relleci ilie ihougliis of our 
leaders, who speak Thn7tigh our piiges. 

You are invited to involve yourself in 
this exciting conversation arntjngst readers. 
No mutter w ho you are, no matter wEiat ytjur 
caxlentiaLs may Itc, if you have a tale to tell, 
a uick 10 share, a teclinicpic to leacli, we 
want you to consider joining the family of 
those who write for MacTech. 

Don’t just wail for a topic to be covered 
or a technique explained in MacTech! Take 
responsibility! Write us an article yourself! 

To write for MacTech^ just send for our 
'Writers Kit. It's a Microsoft Word flic 


containing rlie Styles you need to use, and 
giving lots of helpful arlvke and infonnation, 
including all the legal stuff. Ytai can let us 
know what youVe writing alKHU, or, if you 
want to, you am just write tlie article and 
spring it on us when it's done. [Note: We 
also have a need for people willing to make 
ihemsclves available to write tx.'casional 
f>njduct/l)Ook review's.) If we publish your 
article, yrju'il Ix^ paid for it! 

Write to us, ihe editorial staff, at 
ediTorial@niixneclLcoiii (or one of the other 
addresses listed on page 2 of the magazine). 
Take the future ol' MacTech Magcmrie into 
your own hands! 

r ri lTiMf n * il i m/ l t fi rr t 
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TIPS & 
TIDBITS 



By Stew Sisak 


Colorizing Ptxmaps in PICT Images 

In a progect 1 am working on, I have a set of PICT resources 
that are used to draw a background for my app's user interface, 
Ttie PlCTs are used to represent modular panels and the the user 
is allowed to colorize these Iracking panels. The code to colorize 
the backing pixmaps is relatively simple, but the Mac OS 
provides a gotcha. 

The basic teclinique uses CopyBils to colorize the pixel data 
by setting the foreground and background colors of the 
destination port. The problem is that if you set the colors in the 
port l^efore playing back the piiturc, the DrawPicture routine 
undoes your work for you and ilie pixel data from the PICT is 
not colorized. The following code uses the QuickDraw 
iK>Ltlenccks to circumvent the problem. To use it, call 
DrawColorizedPicture instead of DrawPicture and add the 
colorization colors you want as parameters. 

For example: 

RG13Ct>lt*r red = {Gxfff f,0,0): 

RGBCalor black - 10,0,Oh 
Rect ; 

f! nun a gniyscilc imgc UUo a rcd scalc image: 
bounds “ (• * aRicHatid le J, bounds: 

nrawColotlzedPictureCaPicHandie. Abounds, &black, &red); 

Here Ls tlie code that implements DrawColorizedPicture: 

// Dcfbic some global variables to pass die colorlzadoD ioformatinn 
RG BColor g FGColor: 

RGBColor gBGColor: 

// here b the overriden bonlracck CmyQl>B*tsProcPtr). 

// It sets up die color cnviruniuctit before actually copuig ihc pixmap 

pascal void nyQDBitsProcPtrtBitMap ‘srcBits, Rect 'srcRect* 
Rect *dstaect, short mode, RgnHandlp maskRgn) 

I 

GrafPtr curPort: 

RGBColor saveFGr 

RGBColor savsBG; 

Get Por t f&cur Port) : // gci Ihc content 


// save the fore- and backgniund colors 

saveFG {(CGrEtlFort' JcurPort)->rgbFgColor: 

^aveBG * ((CGrafFort*IcurPort)’>rgbBkColor: 

RGBForeColor f&gFGColor): //^tthe foregramd color 
RGBHnckColor E&gBGGolor): // scl lllc background color 

// call the standard routine 

StdBitstsrcBits, srcRect, dstRect, mode, raaskRgnl; 

RGBForeColor(&saveFG): /f restore the foreground color 
RGBBaokColor (isaveBG): // r^tone the background color 


// DrawColori7.e<lPiaurie works just like DrawPicture, except it colorizes the 
// the pjxdmap portions of the picture accoiding to the global variables 
// gPGCXilor and gBGColor It assumes the tan 5 et port is a color port 

pascal void DravColorizedPicture(FicRandlp. ph, 

Rect *turgetBouuds, RGBColor 'fg, RGBColor *bg) 

( 

CQDPr 0 ca myPr0cs: //new bottlenecks 

CQDProcs *old?roefi: //saved boRlcnecks 

Graf Ft r curPo r r.: // the active GnifPon 

static QDBitsUPF theUPP - NUU; //the UPP for our SldBlts (tplacemcni 


if (thedPP = MULL) I //allocate the UPP if it docs not exist 
theUPP * MewQDBitsProcCinyQDBiTsProcPtrl : 

I 

gFGColor ^ *fg: //communtaie coloriiatjua to the bottletieck 

gBGColor *bg; 

Get Port (iourPort): //find the current ptirt 

SetStdCProcs(irayProcs): // initial \7C the botdcttockrecord 

myProc5,bltsProc “ theUPP://insert our StdBlts Bottleneck 

// save the prcviotis Bottleneck reciuxl 

oldProcs “ ((CGrafPort * )ciirPort)->grafFrocs: 

// attach our boidcneck record 

({CGrafPort*)curPort)->grafPrucs = ftniyProcE; 

PtawPictur^^fph, targetBounds): //draw the picture 

// restore the bmtUieck record 

((CGrafPort*)curPort) >grafProcs = oldProcs: 

R.J. Buchaltcr 

bj@metric-halo.coni 

B 
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by Jessica Courtney 


Tiie First Universai- Communications API for all Types of 
ftttmxxn.s AND Media 

Griffin 'Technologies, LLC and Langncr GnihH are pleased to 
announce the release of the Langner Universal ConununicaLions 
API (LUCA), tlie first programming component for data 
c:ommunications that integraes support for all of the popular 
transmission media and protocols in use today. LUCA supports 
TCP/IP services including FTP, HI’l'P, 'Telnei, SMTP, TCP sockets 
and UDP sockets; async prot<x:ols including fax, dial-up 
modems, Zmodem, Xmodem and 3964R; ISDN services including 
X.75» HDLC, voice and fax; and sync protocols such as HDLC, 
BSC, SDLC and Frame Relay. 

All of these protocols and the corresponding transmission 
media are accessed using the same, concise set of API 
functions, making it possible for the first time to write reusable, 
media independant code for data communications. This 
universal architecture enables LUCA to support many 
sophisticated communications tasks including block 
transmission and networked links. 

A free evaluation CD of the bmgner Universal 
Ct)mmunicaiions API is available. This CD contains working 
libraries, fuill online dtxrumentation and ready-to-ain sample 
programs including source code. 

<http://www.9rtftech.c0nn>, <http://wwwJangnef.com>. 

Stairways Releases S iheamWatcher UO 

Stairways Software, Pty Ltd, announced the release of 
version TO of Stream Watcher, an Open Transport TCP Stream 
debugging utility. 

What is Stream Watcher? 

StreamWaLcher allows you to examine the data transniiUed 
through Open Trans|X)rt TCP streams. 'I'his is useful for 
debugging network applications and neiw'ork problems, 
learning alxmi networking protocols, or watching for strange or 
unwanted TCP traffic. 

If you liave ever wondered wliat your computer was saying 
when it was talking to other machines on the network, this 
program is the answer. Stream Watcher requires a PowerPC 
(Power Macintosh or clone) and Open Transport. 

Stream Watcher is shareware, single user licenses cost US$35t 
site and company-wide licenses are available. 

Features 

• Stream Watcher can examine all Open Transport TCP 
streams (using "OT AutoPush Suppon" from Quinn), 
allowing you to examine networking traffic for any 
application on your computer. 


• StreamWarcher can display multiple streams simullanetjusly, 
cither in a single window, or one stream in each window. 
This allows you to watch sessions where many different 
connections are made (such as a web browser downloading 
a page with pictures). 

• StreiunWaicher tun display the stream dna in text or binary 
mode (automatically or manually). 

More Detail 

Stream Watcher displays all the data sent through any TCP 
stream on your macintQsh, whctlicr the c:onnection originated on 
your Mac or not. It displays each stream in its own window (or 
if you prefer, all data can be directed to a single window), 

StreamWatcher can examine any connection without 
rec]Hiring special versions of applications, so ii opens up 
networking to closer scrutiny, 'I'his in tom allows you to find 
problems that might otherwise go unnoticed. 

Also, because it can watch many slream.s of data 
simultaneously, it can allow you to debug ctjmplex problems 
involving interact ions Ix^tween multiple clients and servers that 
might otherwise lx* veiy^ difficult. 

<hTtp://www.staifwavs.com/>. 

Tyreil and AcnviiSTAiE Resolve PERLStsiFr Name Confuct 

Name Camflict Ends wiUl Agreement to CxKiperatc with 
Marketing and Devek^pment of Perl Tools 

In a move typical t>r die Perl community, Tyteli Software 
Corp. and ActiveState Tool Corp, have resolved the PerlScript 
name t:onfiict in a friencily, ccx>perafive manner. Last month, 
I'yrell started marketing a product named PeriScript on the 
Internet. Confusion quickly ensued Ixtween ActiveState's 
PerlScript ActiveX scripting engine and TyreU's PerlScripl. 

PowerPerl lirings tlie power of CGI programming witliin the 
scripting ease of HTML using the number one CGI language Perl 
lk>ih novice and advanced users can iminediaiely lake advantage 
of PowctPcH^s abilities. Suited for lx)di the Internet and intmneLs, 
ISPs and system administrators can offer the power of Perl to 
their business clients and iLscrs without security risks by using 
PowerPerfs built in security features. Included is the PowerPak 
Starter Kit, an initial set of PowerPerl libraries designed f^y 
leading CGI developers from around the country. Jhis library 
contains the most requested CGIs gathered by Webmasters and 
Consultants for their clients. 

PerlSciipi is an ActiveX scripting engine implementation of 
Peri that allows any ActiveX scrifXing host to use the powerful 
Perl scripting language. Popular ActiveX .scripting hosts include 
Micixxsoft Internet Explorer and internet Infonnation Server. 
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(...and we really mean now.) 


'Itiink of it as your source of news anti announcements in the 
MacOS developer community. Loaded with up to the latest news, 
and constantly updated with developments in our industry. 

MacTech* NOW brings you up to speed on every thing you need to 
l^now — instantly! And thanks to our new “fa.si-download” design, 
you’ll gel to the information you want in seconds. 

Give it a spin! Check it out today and get access to over 1500 pages 
loaded with new.s, lips, programtning secrets, product reviews, and 
much more. And for those of you looking for some kicks, there’s the 
ever popular “Programmer’s Challenge” .section where you’ll get to 
bang heads wiili the best in the eominunity. 

Log on to MacTecii NOW. Things are happening right now, and you 
sitould Ix' aware of them. 



MacTech is a registered trademark of Xplain Corporation. MacDev-l, THiNK Reference, Deveioper Depot, Sprocket, 
JavaTech. WebTech, BeTech, and the MacTutorMan are trademarks of Xplairi Corporation. Other trademarks and copy¬ 
rights appearing in this printing or software remain the property of their respective hoiders. 





In addition, <hltp://www.peTlscrtpt,com> and 
<hltp://www.perlsaipt.net> wiSl be inainuiined by Tyrell but will 
direct users to iK>Lh pRxIucts. 

<http://www.ActiveState,com>, <http://www.tyrelLcom>. 

SeRVUTEXEC PLlfGlN Rl/NS JAVA SERVLETS OM MAC OS 
Web Servers 

New Atlanta Communications, LLC announces the 
ServletExec plugin for Mac OS web servers. ServletExec is a 
WebSdAR API (W^API) compatible plugin dial enables Mac OS 
web servers to nm industry-standard Java servlets. ServletExec is 
built on tlie Mac OS Runtime for Java (MRJ) which Apple is 
sliipping as a standard component of Mac OS 8. 

Tlie servlet applicatitsn programming interface (API) was 
developed by JavaSoft, a business unit of Sun Microsystems, Inc., 
and impleinentetl in their recendy released Java Web Server. 
JavaSoft Iras also developed servlet adapters for Netscape and 
Microsoft weh servers, as well as the Apache weir server By 
enabling Mac OS web servers to also run servlets, the ServletExec 
plugin helps realize Java's goal of "write once, run anywhere." 

Feature Summary 

• Run industry standard, 100% pure Java servlets on your Mac 
OS web server. 

• Use any Mac OS web server thar suppons the W*API standard. 

• Based on Applets Mac OS Runtime for java (MRJ). 

• Supports Java 1.0.2; suppon for Java LI will Ire added in a free 
upgrade when Apple's MRJ 2.0 ships witli Java 1.1 support. 

• Built'in server-side includes (SSI) for emlredding servleLs in 
inm pages. 

• Supports servlet chaining and filtering. 

• Supports remote loading of servlets over the Internet. 

• Reloads modified servlets witliout restarting the web server. 

• Includes servleLs for supporting image maps, page counters, 
forms-based email, and more. 

• Includes sample projects for servlet developers using 
Metrowerks Code Warrior, Roaster Technologies Roaster R3, 
and Symantec Visual Cafe. 

The final release is planned for early October. 

<http*y/www.newatlanta,com/>. 

PowerKey Pro, Modei. 600 

Sophisticated Circuits, Inc., based in Bothell, WA, USA, 
announced the immediate availabiiiry of tlie PowerKey Pro 
Model 600. 

PowerKey Pm Model 60D is a major new vemion of the 
company's PowerKey power imnagcment devices for Mac OS- 
based computers. PowerKey Pit) Model 6(X) pn)vides new levels 
of convenienc'e, productivity, and capability. The device is a six 
outlet, programmable power strip that offers software control over 
individual outlets, energy conservation features, the ability to 
execute timed macros, and remote power managemenr features. 

Eat:h of the six receptacles on PowerKey Pro Model 600 can 
be conUTolled by the manual switches on the unit, or under 
software contn>l using rhe PowerKey Pro software included witli 


the product. Tlie PowerKey Pro Model 600 can also be controlled 
by telephone or from anolfier application program using Apple 
Events or scripts generated with scripting tools such as AppleScript. 

I'he convenience of keyboard startup 

With PowerKey Pro, users can turn on an entire Macintosh 
system, including up to five peripheral devices, simply by pressing 
the "power on" key on their keyboard. In addition, the device 
enables the user to delay nr setfuence the start up of the CPU or 
selected peripherals. Using iliis c'apalnlity, users can set PowerKey 
Pro to delay CPU startup until SCSI devices are initialized. 

Individual peripherals can also be turned on or off directly 
from the keyboard by assigning die device to a user-defined "hot 
key" combination. For example, a printer could be started by 
pressing the assigned funaion key. 

Pf>werKey Fro also allow.s the user to shut down die entire 
system automatically simply by seiecting the Shut Down 
command from the Special menu. 

Sophisticated remote power contrt>l 

In die past, a mobile computer user who wished to access 
tlieir desktop Macinicxsh would leave it turned on while traveling. 
With PowerKey Pro, die desktop machine can be left off when 
leaving the office. 'Ihen, by dialing ilieir cksktop modem number, 
die user can remotely start up their desktop ctimputer. Using a 
PowerBook with remote access software, the user can iraasfer files, 
perform remote operations, or read e-mail When the user has 
finished. PowerKey Pro wUl safely shut down the desktop system. 

PowerKey Fro Model 600 provides the ability for users to 
assign telephone tone codes to various actions, giving them 
com[ilete control over their system from a telephone anywhere 
in the world. Tone sequences can act as a '^seairity code" for 
starting up a computer, or allow users to control different outlets 
will] different codes. This provides greater security and control 
over your computer system while on the road, 

PowerKey Pro al.s<i includes software dial allows users to 
liefine which oudets sliould be powered on during a remote 
.start-up. For example, if a user doesn't need to start up their 
entire system, PowerKey Pro can start the modem and CPU while 
leaving monitors, printers, or other devices off. Users can even 
pre-determine the hours available for remote start-up. 

Launch macros automatically 

With PowerKey Pro, users can perform lime-consuniing 
tasks in the ofF-hours. The device includes sophisticated 
scheduling software that can start up the CPU and a selection of 
devices at a pre-determined time, launch applications or 
AppleScjipts to control unattended events, then shut the devices 
down again. This capability can l>e used for routine operations 
such as system backups, fde transfers, e-mail retrieval from 
online services or document priming. These tasks can be 
performed in rhe middle of the night, enabling the user to focus 
on productive tasks during the day, 

<http://www.sophisticated .com/>. 
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Ohjechtvt Software announces the new release of 
OnfStep 1,1, 

OneStep is an extension tfiat iransfonns your Mac's user 
interface. Features int:iLKie t ustoni windows, menus, pop-ups, 
scroll l>ars, buLU)iLS, folder and trash icons, anti mt^re. 

OneStep corner with a numlxfr of ready to use interfaces, 
such as "'I'nie NeX*P (a genuine NeXT-like interface), "Jump to 
Fight'’ (guess what ii Ls?), Back To Seven, Grand l^rix, etc. Each 
interface is contained in an Appearance tile. Advanced users will 
be able to design and distrihote their own customized 
Appearance Files. 

OneStep requires a Macintosh or Mac;OS-cojnpatible 
computer running System 7.0 or later. 

OneStep was written by Harry Alloul, Bernard Frangoulis 
and Aiessandro Ixwi Montalcini. It Is distributed as shareware. 
Tiic Registration fee is $1S; registrations are handled by the K^tgi 
Shareware .service. 

<http://www.netinto.fr/objectivesw/> 

Paris. July 29tli, 1997. 

FlX>RtNT PlLLLT ANNOUNCES POWF.rGu)T* THE SOI IWARE 

Localization Tckii. for MacOS, 

PowerOlot is a new solrware localization tool for the 
MacOS. Flist and etisy to use, PowerGlot allows developers to 
localize their software to any language available on the MacOS 
plaiftmn, including 2-byte languages like Japanese and Chinese. 

The stjftware is WorldScripi aware, scnptal>le, supports 
drag-and-drop, balkx>n help and AppleGuide, all this wrapped 
in a convenient and intuitive interface. 
<http://www.teaserTr/-fpillet/PowerGlot/> 

Visual Bauxxws for PowehPlan i 

Tools 8l Toys unleashed Developer Release 1 of Visual 
Balloons for PowerPlant, a set of libraries and editors that allow 
easy creation of standard Mac OS Eialioon Help for PowerPlant 
projects. Using Pow'erPlant Constmetoris simple drag ik drop 
interface and only two lines of C++ code, MacOS Codewarriors 
can now add Help Balloons tliat are not limited to plain text 
only, but instciid support piaures and styled text as well. 

Until today, developers who wanted to integrate 
Balloonllelp into their st)fiwarc had to use Apple's KesEdit or 
Mathemaesthetic's Resourcerer and were Iknitetl to the user 
inLerfuce elements built into the Mac' OS. 

Visual Balloons includes tlie following new Fow^erPIant 
classes: 

• Visual Balk Km String - the String ball(K>n eml)cds up to 255 
characters for direct editing in Pow^crPlant Constructor. 

• Visual Balloon 'STR ' - displays a 'STR ' resource in a 
balloon help. 

• Visual Balloon 'STR^' - this balloon takes a string from a 
string list resource. 

• Visual BallfK)n 'TEXT - a help balloon that displays styled 
text fmm a TEXT resource. 

• Visual Balloon 'PICT - a class for viewing PICl’ resouRes in 
a help baDoon. 


• Vi.syai Balkx>n Toggler - attached to a Control, this class 
turns Balloon Help on or off without any additional 
programming. 

Key FeaHiroi 

• Seamless integration with PowerPlant Cxinstnictor 

• Easy to use through Drag Si Drt>p. 

• No sulxJa.ssing FC(]uiRd. 

• Installs in Ic.vs tJian 5 minutes. 

• Only [wo additional lines of c(kIc to write. 

• Supports "embedded” strings, styled text, 'S'l'K ' and 
resources, and PICls. 

<http://www.ToolsAndToys.com/>. 

The Debugger and MacNosy 
Jasik Designs posted the latest versions of it's prcxluct: HTie 
Debugger ik MacNosy' on their ftp site. Notices were also e- 
maiied to ail registered users. If you did NOT recieve an update 
notice from Jasik, then you should e-mail Jasik at 
<maillo:macnosy©jasik.com> with you name, address and current 
e-mail address, 

ITie update coasisLs of the release notes, The Debugger, 
Nfxsyll and a newer xDbgr_Stanup (better crn>r mcmiges). 

This version of TTie Debugger is compatal.^le with MacOS 8, 
and the recently released 'Speedbump' Matintoshe.s and 
upc oming CHRP boxes. 

<http://www.jasik.com>. 

WebObjects Adapter for WebSTAH 
SiarNine announced the availability of a W*AP1 based 
WebOi^jects Adapter Wit It a WebObjects Adapter, it is now 
possible to integrate your Mac OS-based WebSTAR server w'ith 
WebOhject applications running on Solaris, OPENSTEP, 
NEXTSTEP, Windows NT and soon Rliapsody. 

WebSTAR u.scrs interested in testing the WcbObjccts 
Adapter with their current WebObjects applit:ations are invited 
\o download a development version of the Adapter at 
<ftp://ftp.staTnine.com/pub/betas/webobjeds_adapter.sea.hqx>. It is 
also requested Qtat you subscribe to the Beta mailing list by 
sending a message to <webobjects-beta@starnine.com> with a 
xSubject of "subscTibe", 

<http://www.starnine.com/>. 

MacI JNE Offers Free Marketing and PRFiis Release 
Dis'i’KiBunoN For Mac Deveu)peks 

MacTimes Machine press release service, located on the 
web at <http://www.mactimes.com/macline>, offers Macintosh 
software developers a free and effective way to broadcast 
information at)out their latest products or upgrades to the 
Mac new.s coiiununity. 

MacLine offers developers the ability to post an unlimited 
numi^er of pre.ss rel(Xiscs on tlie Machine w^eb sire, wiifi no ax>t. 
In addition die piess releases can be broadcast to Mac news 
agencies across the workl, oncx; again at no cost to the developer. 
<htlp://www.mactimes.com>. D 
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The Ultimate Web Server 

On The Ultimate Web Creation Piatform 



Tenon's MativSt Preemptive Mutti-Tashing 
Execution Environment 
^ Squid Object Caching Technology 


^ Complete CGI Support for AppleScript, 
Perl, sh & 3rd-Partv application CGIs 
Supports all popular Web Server Plug-Ins 


Tenon's Native Fast File System and 
Advanced TCP Stack 


Powerful Browser-Sased 
Administration Server 


True Virtuai Hosting & Proxy Service 


MuHIpie Domain Names & IP Addresses 






Virtual Hosting 

» the only Mscmtosh Wob server with *true* 
virtual hosting 

> supports an unlimited number of Web servers 
on a single machine* each with b unique 
domain name and IP address 


Comprehensive Plug-In and CGJ Support 

- Siipport^ all popular Macintosh Web server plug-ins 
■ supports all Macintosh CGIs including AppleScript, 

sli. Pad and 3rd-party applicatiori CGIs 

- largest family of CGI applications supported 
by any Web server on any plaltoim 



WebTon's HTTP Log and Status Windows 


Point St Click Apeche 

■ simpte to in stall and configure 

■ browser based, local or remote 
administration of aJi server sseilings 

Configurable Logging 

• srmullaneous transaction logging to 
different log files 

• multiple tog formats 

Ultra-Fast Disk Access 

• includes Tenon's native fast file sv^lCfm 

• optimized for storing and retrieving 
thousands of small files 



Squid ObJ^t Catching 

- local RAM based objcci cache 
• dynamically caches frequently-requested files 
‘ ten fold Apache performance improvemeni 



WebTen^s Powerful Admiolstr^ion Server 


Enhanced Networking and Seourity 

»inciudos Tenon's advanced TCP stack with 
no built-in limits 

* supports ntulliplQ IP addresses 
end multiple interfaces 

* includes "hacker" protection to prevent 
denial-of-service attacks 

' uses OpenTranspOfl as an alternative 
or parallel TCP stack 


Rhapsody-Ready Architecture 

“ runs in Tenon's pfeemptively multi tasked 
Rhapsrxiy Ilk© oKOCUtton environment 
nevt generalion Mac OS performance todayl 


For more information, or to order 


Call 1 - 888 - 2 -WebTeii 


Details and a trial version available on the Web at www.tenon.com 


MacOS 


MiniiTiMm Syvtem Req utrementA 
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CLASSIFIEDS 


SERVICES 


Great Products Deserve Great Docs! 


DuciifneJilaLiom shuuld Ix' ai\ intrgrni pjirt tj-f 
yuur pniductH, ncH an ftfliHlhrmght. Mjinuiil 
Ubvr sp»s;iaJLiy» m end-iwr d^timmia 
titm tor MadJitiwh* pruditcis, including 
Balloon Help ami Api-le Guide, HTMI or 
TDF fiks^ and the ever-popul.iir "dead ittr 
ctlilmn/' Antt while we'a’ diicumi'nhni^ 
every ruxKk and ttatiiiy of your pnH-liui, 
we am ^imultamxmidy provide evtco-sivo 
usability k^'dbaclw frauJtiug in fmer bugs 
a i^impler user intetiiuxv reducDed supporl 
Cffltls, ird belter review*. 



Contaci us today to lap iIk' expcrtisi^ our 
team ha.*; already brvtuglit lo ttimpauies Idw' 
Ilian' Bones Softwativ id Sottwaru* ResNiiva 
?iohwait?, ManagernentSottware., Quasar 
Kno^wkdge Systenui, and ^'anlrein Quatily 
rnmpiiters. And see why we’rc the best 
choice to dnoiment yotirtiejit Mae produd 

Jerry KindaM 
Bl0/445^««77 
kindal li^nVfiniiat.Cf ml 
hlLpij/ /wwwiruinuiiLcfwn/ 

Y<!e Wrote the Book! 

MaciJitaih Tnfititat! Cotmiiumi^lioif Exfvri!i 


Software Engineers 

I ndustn-leading educational soft wan: conijrain iieecLs cxjxricnced 
Softwiire Prograiuniers in CyO+ programming for Windows or 
Macintosh. Kxccllent s;ilary and iK'uefUs package. A great place lo 
live and develop products that truly make a difference. An 
opportunity witiujui comparison! Send resume in eonfidence lo: 

#145-MAC 1 
Debra Frajiz 

Advantage Teaming Systems 
RCX Box 8036 

Wisconsin Rapids, Wl 54495 
rax (715) 424-3414 
K.O.F. 


r 7“ 

y/MNN. 

. 00 ^ 

Professional software devdopers 
looking for career opportunities 
should check out our web site. We 
ofter nationwide employment assis¬ 
tance, resume help, marketability 
assessment, and never a fee to the 
applicant. 800-231-5920, Fax 800- 
757-9003 eMai I :das @scientific.com 

Scientific 
Placement, Inc. 

'v____^ 





The fastest, cost effective way to get product off your shelves. 

For informalion: • Voice: 805/494*9797 • Fox: 805/494*9798 • E-mail: mari<eting@devdepotxom 
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by Ingrid Kelly and Robin Mikawa, Apple Developer Technical Support 


Using the GXGraphics Extension 


Using The GXGraphics Extension 
Starting vvilh Mac OS BA the 
QuickDraw GX environment no longer 
supports the GX l^rinting Managt^r API. 
Although this decision will require 
significant changes to existing system 
software and applications, it will allow us 
to transition to a unified priming 
architemire that will improve the 
comjratihiliiy of QuickDraw^ GX softwaa^ in 
the classic QuickDraw^ environment. Mac 
OS 8.0 includes the GXGrai>hics IJ,6 
extension, which provides the advanced 
Grapiucs and Typography c^pal'Jilities of 
QuickDraw GX, a QuickDraw- GX c(Klec in 
the QuickTime 2.5 cxteasion, and a fully 
integrated version of the Collection 
Manager ThLs article includes: 

• The changes needed for an application 
(GX aware, GX savvy, and GX 
dependent) to support GX Printing on 
Mac OS 8.0. 


• Where to get the current version of the 
GXGraphk'x extension (1.13) and a 
desc ription of any differences with 
GXGraphics 1.1.6 included with Mac 
OS 8.0. 


• Any known incompatibilities or 
limitations of the GXGraphics extension. 


as well as known solutions to tliese pix>l>lcms. This Article is 
intended to help developers who w'ish to transition tlieir GX 
pnKlucis lo support QuickDraw GX on Mac OS 8.0, 

Note: 'Ihroughoui this Artide, die term, \1a.Hsic printing 
archil ectiire,'' refers to the Macintash IMnting Manager descxilied 
in Cha[>ter 9 of Inside Macinto.sh: Imaging Widi QuickDraw, 
“QuickDraw' GX'’ refers to ihe full GX envircjiiment (he,, 
Graphics, Typography, and Printing) and ^‘GXGraphics" refers to 
the partial GX implementation provitied by the GXG rap hies 
exlension (i.e., Graphics and ‘I ypography). 

Features Nor Supported in Mac OS 8A 
Follow ing is a list of key features that are currently available 
in QuickDraw GX 1.1.3/TT5 that will no longer Ix" availaNe to 
developers under lite GXGraphics l.J,6 strategy: 

• GX Printer Driver Aids: GX Printer drivers will no longer be 
supported. All developers need lo liave a cbssic printer driver 
for their device. 

• GX Printing Extension.^: GX Exieasions will no longer lx 
supported. Some develojxrs imy lx able to roll their GX 
extension functionality into their application nr driver. 

• Custom page formiitiing {the ability to arbitrarily specify page 

h>rmaning w'idiin a single document): 'Phis feature will no 
ttmger be available. This feature could te implemented using 
the extended prim record archlieeiure added with LiserWriter 
version 8.4, See Journal Issue 27: ‘'the All-New 

lascrWriier Driver Version 8,4’ for more informal ion on the 
extended print record. 


Ingrid Kelly works in Apple’s Devclofxr Technical Support group answering questions al>out grapliics, color and printing on 
the Mac OS. In a previous life, she worked at NASA in the ftiunau Factors Research branch studying aircr^ilt pilots, hut she 
Finds dial studying peofde at Apjile is much more interesting! 

Robin Mikawa ha.s recendy returned to her iirsi love a graphics engineer on tire QuickDraw GX project. A three-year stint 
on the WordScript engineering team has instilled her a love for typograpliical irufTles, multilingual system software, and noodle- 
based dishes from ail parts of die world. 
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• Fort;ihle Digital Document auilioring: Developers will no 
longer be able to author PDDs via the GX Printing A?K Also, 
SirnplcTcxl will not display PDDs under QuickDraw GX 1.1.6. 
You should convert PDD Rles to a different format, such as 
Adobe Acrobat PDI' files, l^efore attempting in usc‘ them with 
Mac OS 8 in QuickDraw^ GX LL6 

• Vector Print Driver API: Under die new GX mcKiel, there will 
no longer Ix^ a custom API for vector printer driver developers. 
VcTtor printer drivers will have to l>e written with the classic 
printing architecture. 

OVF.RVrFW OF THF GXGRAPHICS ExTEMSION 

The GXCrapines extension is a system extension that adds 
pow'erfiil graphics and typt)graplnc capat>iliiies to your u.ser's 
Macintosh without requiring the full QuickDraw GX package to 
ix' installed on your user's machine, file extension that we are 
airrently licensing and distributing, GXGraphk's 1covers all 
QuickDraw GX graphics and typography functionality up to and 
including QuickDraw^ GX version LI.3^ 

GXGraphics 1,L3 

Tlie GXGraphic.s 1.1.3 extension contaias GX graphics and 
typography, bui d(x.'S not eonmin GX Printing. There are stubs 
for the GX Printing calls in QuickDmw'GXIih/GXGraphics 1,1,3 
I nil they do not W{>rk. ■f'his extension has lx:en released and 
tested on 7.3.1 through 7.6, See liable 1 for mt}re sixx'ific details, 

GXGraphics 1.1.6 

Tlie GXGmphics LL6 release contains GX graphics anti 
lypogra[>hy, liui will n<i longer have the printing stubs available. 
This extension has lxx:n tested and adejtsetl t(>r Mac OS 8.0. See 
Table 1 for more specific details. 


Name 

Version 

Component 

Gestalt Selector 

QuickDraw GX 

1,13, ?d.5 

OuidcDraw GX 

* qdgn (obsolete) 



GX Printing 

* pmgr 



GX Graphics 

* grtx 



Collections Mgr 

•dtn 

GXGrapliiu 

1,1.3 

GX Printing 

** 



GXGraphics 

* grix 



Collections Mgr 

* * 

GXGfaphics 

1,1,6 

GXGraphics 

•gffx 


* APIs are exporied and available 

** APIs are exported hut nor available; yuu should use the gestalt selector on 
application launch to verity whether or not the funrtions are implemented. 


Table L Differences in ihe QuickDraw GX Reiemes. 

Note: With Mac OS 8,0, the Collections Manager APIs have 
been rolled out of QuickDraw^ GX and into the system. 

Appucation Cilvngls 

Since ilie GX printing architecture w'ill no longer !>e 
supp<irted for Mac OS, any software that does not already have a 
solution using cla,ssic QuickDniw printing will need to be updiited. 
For the maprity of applications, the recommended solution ft>r 


Mac OS 8.0 is to use die QuickTime t:ompression/decompression 
mechanism for imaging QuickDraw GX data. The Ixisie technique 
US lo encapsulate the QuickDraw GX irrutge in a compressed daui 
format using die ol>jeei flattening fitnaions from QuickDraw GX, 
Once the compreiised image data us cTcated, it may be passed to 
the Quit kDraw GX axlec and drawn using die QuickTime image 
compression functions or embedded within a QuickDraw picture 
and drawm using the DrawPiclurc funtaion. In either case, the 
compressed data i.s passed to the tlte low-level QuickDraw- 
drawing routines through the StdPix Ixtttleneck routine. StdPk 
decompresses die data u,sing the Quickl^raw^ GX ccxlec and pas.ses 
the decompres.sed data to the bitsPrex' IxiUlcneck rouline W'hen 
rendering the image, 

LaserWriter drivers starting w-tth version 8.3 recognize 
compressed data that may lx: drawn using Quicklime, like 
QuickDraw- GX flattened objects. For Mac OS 8.(1, die DiserWriter 
driver has lx;en m<Kiified to render the QuickDraw- GX data at 
the device resolution of die printer. When desp<ix)iing, the printer 
driver changes the resolution of the ofTscreen drawing port and 
usc‘s the QiiicDraw- GX cxxlec to rasterize the compres^sed data. 
Tlie QuickDraw printer tirivers from Apple render the 
compres.sed data during s|XHjling and u.se ihe resolution of the 
active graphics port. Application develojxTS may wish to use the 
device res(dution commands of the Prlkmeml routine to improve 
the quality of their printed images as descTibed in “Meet 
PrGenenil, the Tnip That Makes tlie Mn.si of the Printing 
Maiiagei/’ in ciemb!) 3. 

General Changes For Au, Applications 
'fhe sample ctxle for tliis Article includes ujKiaied versions of 
three QuickDraw GX user libraries, OxlecLibniry, PrindngLibrary, 
and StonigeLilirary', tlial may lx: used to simplify the conversion 
of VLRir software. Tlie TwoFace sample applrt alion .supports the 
biLsiL job, format, dialog, and sprxding functions of the 
QuickDraw GX Priming Manager, Ii uses an abstraction layer 
providixl by the Printinglihrary to handle printing through the 
QuickDr:i\v GX and classic QuickDraw- printing arcliitectures, 
depending on which environment is available w^hen the 
application is launched. All the changes desciilied in this section 
are handled auttimatically by the user libraries if you simply 
convert any references to the QuickDraw GX Prindng Manager, 
including the gxjob and gxFormat data types, to the equivalent 
functions and data ty|X‘Si>f the PriniingLibraty. 

DCheck tiie corrett gestalt .selector. Use the individual grfx 
and pmgr gestalt selectors ratlier ihan the obsolete qdgx 
ge,stalE selector. 

Boolean gPrintingArchitectute “ false; 
long theFeature: 

if ( alt Graph IcjsVetslan, itlieFeature) noErr ) 

rpturo: 

if t Gestalt(gestaltGXPrintingMgrVersion. &theFeaturft}!= nnRrr J 
gFrintingArchitecture - kQDPrArch: 
else 
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^Pr I nM iigArrliU &c i lire " kGXPrArch; 


2) For 68000 applications that use A-tmp addresses to determine 
which paits oF the GX environment are installtKl, use the 
individual gestalt selectors instead. This techniciue is not 
recommended but has been used by some appliaitions in the 
past If this is the case for your application, verify that you are 
checkin^^ the correct A-trap addresses: 


Trap Address 

ABFK 

A832 

ABF6 


Tecimology 
GX Priming 
GX Graphics 
Collecticms Manager 


lcx)p. StdPix is descTilied in tievail in Inside Macintosh: 
QuickTime, pages 3-138 to 3-139. 

SfECIFIC CHAtVGES REQUIRED BASED ON LeVEL OF SUPPORT 
Plere is an outline of the changes GX applications will need 
to make. They are outlined according to the level of GX supjxjrt. 

GX Unaware (nc» knowledge of GX) 

• No changes are needed 

GX Aware ( implements core GX Printing features) 

• Classic Printing code should lx- added using tlie new priming 
user library. (Step 1-7) 


3) During initialization of a Powerl^C a[>pliaition, check if tJie 
QuickDraw GX Printing library is installed. If tlie application is 
"weiik"' linked to the library, the Paxess Manager will launch it 
even il' tlx- library Ls missing, aliliougii die C<xlc Fragment Manager 
will not resolve tlie addresses of tlie functions in tlie libiury. tf the 
appliaifion aills any of these funaions, it will cnish. Your 
application should check if any of ilie Printing Manager functiorLs 
cannot lx resolved and exit graceliilly if the library is missing. 
Note thiir the check could be pertbrnied agiiinst any ilinaion you 
c:al] in the library. CXTnitPrinLing Ls often the first function lliat is 
c^alled from ilie Printing Mamtger, so it is a>nvenient. 

if { (Ulnt32)GXTnitPi'iatLii|^ = UnresolveaCFragSymbalAddress ) 
gPtintingArchitEct.iijre = kQDFrArch: 

4) During printing, create a single picture shape for the contents 
of each page in the document. The Printinglibrary inctkides a 
sample viewptJit filler function that handles this task from 
within the printing loop. 

5) Use GXFiattenShape lo create the comprt^ssecl data for the 
QuickDraw GX codec, GXFlallenSliape is descrilxd in detail in 
Inside Madnto.sh: QuickDraw^ GX Objects 2-88 to 2-89. 

6) Use Deeomprt^sslmage as dest:rihed in “Printing Images Faster 
With [>aUi Compre.ssion\ in £ietH.4op 24 (December 1995) to 
eremite the QuickDraw picture with the emixdded QuickDraw^ 
GX data. When the application t:ails the standard DrawPicliire 
function to display ilie image containing tlie compressed 
QuickDraw GX data, the StdPix function decompresses the 
image by invoking the Image C^ompressiofi Manager. Tlie 
Codeclibrary iniiilemenls a function, GXCdShaf>cToPiclure, llial 
encodes the QuickDraw GX data as QuickTime compreased 
data and creates a PicHandle; an application may iLse this 
routine to create a QuickDraw picture pricx to cnlcriag the 
printing loop or to conveit a QuickDraw GX document to the 
QuickDraw PICT file format. Decompresslmage is described in 
detail in Inside Macinltxsfi: QuickTime, jyages 3-78 lo 3-79. 

7) An alternative to Step 6 is to pass the flattened QuickDraw GX 
cUita directly to the custom StdPix Lx>ttleneck installed by the 
printer driver during printing. TTie Codeclibrary Implements a 
function, GXCdDrawSliape, that converts the QuickDmw GX 
data to a Quick! inie encocieci PixMap data structure, which it 
passes to ihe QuickDraw GX c:fxlec from within the priming 


GX Sawy (implements support for Graphics, Typography 
and Printing) 

• Classic Printing ctxle should be adtled using the new printing 
user library. (Ste|) 1-7) 

GX t>ependent (requires GX to he installed to function) 

• Classic Printing code should lx added using tlie new printing 
user library. (Step 1-7) 

Additional Changes 

Custom Page formatting 

• CurrenLly, applications tlial wish tt) implement eiisLorn page 
lonnatling will liave to spcxil multiple jobs |x.t dtxumcnU One 
joli for each diange in tlie page formatting. 

ft Ls im[x>itiinl to note, Uuit even today — on System 7.5*x — it 
Ls possible lor an application u.sing GXGmphics 1.1.x to print using 
the classic printing mechanism destxibt^d ahwe. 

GX Printing Extension Changes 

Printing extension.s have been used for a wide variety of 
tilings in the history of GXPrinting. However, despite tlieir 
potential for optimizing printing from certain kinds of 
applications, they have never been developed or used to their 
lull poLeniial by many devclo[KT,s. Unfonunalcly, under the new 
GX model , GX extensions are no longer available. Some of the 
functionality that developers have used GX extensions for can be 
rolled into clas,sic a]>plicalions or drivers, hut tJmt will have lo Ik* 
determined by the developer on a ca,se-by-ca,se basis. 

GX Printer Driver Changes 

Under the new GX model, GX printer drivers will no longer 
lie supported. There is no transition plan for these drivers. 

Classic Printer Driver Changes 

• In the world of GXGraphtcs 1,1.6 it will be desirable to print 
GX ol)jcm to c:las,sic primer drivers. 

Raster 

• For ra,sfer primer drivers, the output from an updated GX 
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application should match the high quality output today from 
GX drivers. 

PostScript 

h'or PostScript printer drivers however, there will be some 
cfianges recjuired to add supporr for printing high-quality GX 
objects. We are currently working on detennining what the l:)cst 
delivery mechanism for these changes will be (a library, an new 
API, ate.). As stxjn as we have a better idea of how to do this, 
we wid update this Article to reflect die necessary changes. 

PDD Changes 

Under the new GX architecture, there is no way to author 
PDD documents. Also, SimpleText will not display FDD's under 
QuickDraw GX 1.1.6. You should c:onvert PDD files to a different 
format, such as AdolK^ AcTol)at PDF files, iMjforc attempting to 
use them with Mac OS S or QuickDraw' GX 1.L6. 

Incompatibilities and limitations 

lliis section descrilx^s tlie known incompatibilities and 
limitations, and their solutions for the GXGniphics 1.1.6 exteasion: 

• Current versions of printer drivers may generate laige spex)! 
files and take a lf>ng time to print when printing documents 
containing QuickDraw GX data. In addition, QuickDraw' GX 
data printed to the Apple Color LaserWriter may be printed at 
less than full printer re.so!utton. 'rhe.se problems will be 
addrc.ssed in future versions of printer drivers fre^m Apple and 
other vendors. 

• With ATM 4.0.2, some PDF documents that use ATM 
substitution fonts may not print correctly using liic LaserWriter 
8 driver, 'Ibis problem will be fixed in a future version of 
LaserWriter 8 which w^ill be available In late summer 1997. 

• ATM 3-8.3 and 4,0 do not currently recognise that QuickDraw 
GX is installed when the GXGraphics extension is in your 
user's system. This causes problems with Type-1 enabled 
fonts. This problem has been fixed with the 4.0.2 release of 
ATM by Adobe Systems. Check with Adobe for a new^er 
version of ATM Deluxe. 

• Some older QuickDraw pictures with embedded 
QuickDraw GX data may print with random noise in the 
background of the picture. This problem will be fixed in a 
future version of QuickTime, 

• Some QuickDraw GX data may print incorrealy in low 
memory conditions. You may notice that parts of the image 
repeat rather than the entire image printing correctly. Tlii.s 
problem is in the QuickDraw GX QuickTime Codec and will 
be fixed in a future version of Quick'l'ime. 


WiiERL lo Get GXGkaiwcs 1 . 1>6 ajnd How to LioiNSE it 
The GXGraphioi 1.1.6 extension 

• GXGrapliics 1.1.6 is only available a.s part of the Mac OS 8.0 
package. It is equivalent to the GXGraphics LI.3 release witli 
a new installer and PFC library changes. 

Software Licensing 

• For developers who wish to ship the GXGraphics extension 
with their product, you must contact Software Licensing at 
<swJicense@3pple.com> or call them at 512-919-2645, Reference 
the QuickDraw^ GX software license to make sure you get the 
appropriate licensing agreement. 

Conclusion 

By simply ffil lowing the above steps, you should easily he 
able to convert your GX applications into a viewable applications 
that your users will be able to use without having the complete 
GX extension installed. 


Further Referencts 

• Inside Macintosh: Imaging With QuickDraw 

• Inside Macintosh; Quk:kDraw^ GX Graphics 

• Inside Macintosh: QuickDmw GX Objects 

• Inside Macintosh: QuickTime 

• ‘'The All-New LaserWriter Driver Version 8.4”, in develop 27 by 
Dave Polaschek. 

• “Printing Images Faster With Data Compression”, in deiJebp 24 
()y David Gciphman. 

• “Meet PrGeneral, the Trap That Makes the Most of the Printing 
Manager”, in develop issue 3 by Pcic Alexander. 

• "A Print Loop That Cares—The Sequel”, Technote 1092 by 
Ingrid Kelly. 

• “Adding hems to the Printing Manager’s Dialogs", Technote 
1080 by Ingrid Kelly and Dave Polaschek. 
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by Brian Bechtel, Apple Computer, Inc. 


Copy Protection and Serial Numbers 


Co})y })rotection is bard, and it is 
difficult to find a scheme which is not 
easily broken, ne Mac OS was not 
designed mth copy protection in mind, 
and there is no unique serial nurnher 
available on Mac OS based computers. 
Were are some techniques which can be 
used to help differentiate betieeen two 
Mac OS computers, and these techniques 
are descriht^d in tht article. 

DTS does not support copy protection 
because of the significant com}}alihilily 
liabilities it involtjes. This article is a 
summary of some specific techniques 
which hatfe used or recommended in 
the past. DIS does not maintain e:)q)enise 
in copy im^leciion techniqtm. Serious co^ 
protection is much more complicated than 
this article describes. 


number only because the lisa (upon which it was based) had 
a serial number as part of the Lisa design. 

Itiere are some hardware devices, found on a limited range 
of Mac OS computers, which contain some unicjue identifier 
whicli could be used as a serial numl>er. Examples are an 
Ethernet card installed or built-in Ethernet. O'his is because 
Ethernet devices have an unique ID defined for each device.) 
Some (but not all) hard drives have a serial number which can 
l:>e read using the SCSI Manager or ATA Manager. Other devices 
such as Token Ring cards or FireWire may alsr> provide an 
unique identifier w'hich may be used as a serial number. None 
of these hardware devices can be found across the entire 
Macintosh product line. 

SEMl-lfNlQllE CHARACTERISTICH 

11iere are some "semi-unique” characteristics w!uc:h you 
okn use to lielp you determine if you are running software on 
die same machine which you were running on liefore. 'fhese are 
listed roughly in the order Fd recommend considering them. 


Uniqiteiy Identifyung a 
Mac os Compitter 

In general, tiie only consistent serial 
number on a Mac OS based computer 
computer is on the bar code label which 
is attached to tlie outside of the case. 
There is no internal serial number on the 
logic board of any current Mac OS based 
computer computer Tliere is no internal 
serial number associated with the 
operating system. The only Macintosh 
with a real builtdn serial number was the 
Macintosh XL. This machine had a serial 


File ID References 

You can create and store the file ID reference for the 
application file. Create a file ID reference using 
PBCreateFilelDKeR) and store it in an appropriate place. (An 
example of an appropriate place would be the preferences file. 
An inappropriate place would be the applicaLit>n resource fork, 
since litis would prevent your application from running from 
locked media or a network serverj Compare the file ID 
reference to tlie file ID reference of the running application (the 
file ID reference will be in the ioFilelD field returned by 
PBOetCatlnfo), If it isn't the same, you are running on a different 
volume. File ID references are unique within a particular 
volume; they dont get reusetJ. It’s unlikely that two machines 


hmn Bctiitcl works in Developer Technical Support ai Apple Computer, where he deals with PC Cards, Powerlkxjks, and 
device drivers. In his ntm-work life (yes, there is such a thing) he enjoys time wnth his family (Mary, Meg and Tacy), Is i>a.ssionate 
alx>ut the San Jose Sharks hockey team, and plays lousy acoustic guitar. 
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will give you the same file ID reference for the same file* 

// AikiRldO creates i ftlt ID refereno: for the 
f! flic iipccLijcd by the FS!^>cc. U returns the 
// created file ID reference so that yem can store 
// tills reference for future use. 

// 

OSErr AddFIlclDfESSpec ’file* long “fllelD) 

I 

OSKrr ere: 

HPanufllkEti: h: 

h ” (HPaniLBlkPtr)KowPt rClear (slzeof tllParaniBlockilec]}; 

h->fidParatii. ioContpletlon “nil; 
h->fidParflni* ioKantoPLr ^ file->naJDe: 
h->f{dParara^ipVHcffJuiE file->vRefNuM; 
h->fIdPartim.toSrcOirlD •“ file->psi:ID: 

err = FJ&CreateFileIDRefSync(h) : 

‘fllelD “ h->flciParain* ioFilelOi 
DisposePt r(tvoid *)h); 
return(err); 

I 

// (idFilclD returns the Itlc ID reference for a file 
// where the File ID reference has previously hecn 
// created (by calling FBCreateFilciDRd) 

// 

OSErc CetFilelDCPSSper long ‘filelD) 

OSErr errt 
CInfoPBPtr clnfo; 

clnlo (CliifoPQPtr)NewPtrClp.£rfsizeof CClnfoPERec) J: 

elnfo’HFllelnfo.loCofflpletian = nil; 
clnfo->hFilaInfo. ioW^moPtr ” file->tiaiie: 
clnfo OhFllflTnfo* ioVRcfNmii ^ file->vRefNuiD; 
cInfo->hFneTnfo.loFDirindex ^ 0; 
clnfo->hFlleInfo.ioDirID = fil€->parID; 

orr = PBGetCatInfoSync(clnfo); 

•fllelD = cInfo->hFiieItifo-1oDlrID; 

DifiposePtr((void •)cTnfo); 
returnferrl: 

1 


Ethernet Address 

For those Macs which have an Etliernei card installed or 
built-in Etlicmet, you can use the EGeUnfoO calf with a 
esCode of ENetGctliifo to gel the currenciy assigned Ethcniel 
address. See inside MacintosiiiNetworking, page 11*26 and 
11-36 for more information. Apple publishes sample code 
demonstrating how to olHain the Ethernet address under 
Open Transporc 

The complication for this technique is Lliat the default 
Ethernet address may be overridden by a resource of tyfxr 'uadr' 
in the System file. This is documented in Inside 
MacintosicNelworking on page 11-26, Because it is easily 
possible to override the hardware address, and lx:cause 
Ethernet is not guaranteed to exLst on any particular model, this 
is not a gtxxd scheme. 

Similar techniques can he used for a Mac OS computer with 
Token Ring cards or other cards, but a discussion of these cards 
is ouLsidc the scope of this diKuineni. 


Hard Disk Serial Number 

Some hard disks have serial numbers. Many ATA drives 
have such a serial number, but most SCSI hard disks do not. 
Apple publishes A I'A demo sample anlc which shows how to 
get the serial number of an A'l'A drive. Only some Macintosh 
models have ATA drives, so this is not a good general 
puqiose sc'heme. 

SCSI Defect List 

Some developers use the defect list from a SC^l drive. 'Ibis 
won't work for a non-SCSI machine, but might be a good 
approach for a SCSI based Mac:* See the SCSI-2 specification 
and Inside Macintosh . Devices for details of using the SCSI 
Manager. Source code demonstrating use of the SCSI Manager 
in a general case is on the tool chest developer CD. Only some 
Macintosh models have SCSI drives, so this is not a good 
general purpose scheme. 

Directory ID of the System Folder 

Compare the diriD of the System Folder. Use 
FindFolderO to get the dirlD of the System Folder, and 
compare it to a previously stored parlD. This isn't quite as 
unK(ue as the file ID, since the system folder as preinstalled 
will tend to have ihc same directory ID from one machine to 
another. If the user creates a new System Folder (e*g. by 
doing a clean install of System Software, which appears to be 
a frequent activiiy when upgrading) then you will have 
different directory IDs. This is not a good scheme. 

// (kiVolumcDirlD returnii the dirlT) of thr System Folder 
// 

OSErr SetVoluaicUirlD (long * dir ID) 

I 

OSErr orr; 
iiliort riotUsed: 

err=FindFolder(kOnSyEteittDiRk, kSysteniFolderType* no. 
notUsed,dlrID); 
return(err); 

I 

Voluiroe Creation Date 

Compare the creation date of the volume. You can get this 
information from PBHGetVlnfoC). This isn’t tiuite as unitfue as 
the file ID, since ilie volume creation date will be set at tlie 
fiictory when system software i.s placed on the volume and 
will only reset when a volume is reiiiitiali>:cd. Because this 
value tends to remain the same for a given set of machines, 
this is not a good scheme, 

long CetVolCreationDflte(short vRoTNun ) 
i 

OSErr err ^ noErr: 

HParauiBlockRec pb; 

Str2S5 vNawie; 
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vName [ 0 J = '\0 *i 
pb.volumeParam.ioCompletion * nil; 
pb^volumeParajn. ioNamePtr - vHamet 
pb. VO lume P a r am. ioVRefHtim = vR.efHum: 
pb *vo1i]iiiePa ram. loVol Index = 0: 
err = PRHGetVInfoSync ( Sipb ): 

return ( pb. volume Pa ram. ioVGrDat): 

r 


Network Registration 

Rather than identifying an unique Macintosh, you may 
decide that you want to prevent multiple copies of the same 
application running on a network. The method some 
developers use is to register a fictitious device on the network 
using NBP (Name Binding Protocol) with the name being 
single serial number of tlie license. Other attempts to register 
the same device and serial number give an error that the 
program acLs on to deny the use of the program. Chapter 3 of 
Inside Macintosh: Networking is a useful reference for NBP, 

r 

* A entity with the spcdtkd object and type on the 
' specified soclfct.The pointer to the NamciTabtcEntry b 

returned in ntePtr if the function returas noErr. 

t 

V 

OSErr HyRegi8terHaiQt?(ConstStr32Paraii!i euLilyObjcei, 
ConstStr32Farai3i entityType, 
short socket. 

HamesTableEnt ry * * ntePtr} 

1 

MPPParamRlock rappPB: 

OSErr result: 

Str32 eiitityZone = 

r Ahocaie noii-rcbcalaljfc memory in the system heap for 

* ihc uatnes table eiuity 

V 

*ntePtr = (NamesTableEntry *) 

HewPtrSys({Size}aizeof(HamesTableEntry)}: 

if ( nioPtr == NULL ) 

I 

result = HemKrror {): /* Return memory error 7 
1 

else 

E 

/* BuiUl the names table entity 7 
NBPSet.NTE( fPtr) *nr.ePtr, 

(PLr) GiiLityObject, 

(Ptr) entiryType* 

(Ftr) eutityZone. 
socket); 

/* ioRdlNum and esCude are filkd in by 

* PRegbtcrName’i glut 7 

mppPB. NBP interval = 0x0 f: T Reasemabk values hir the 7 
mppPB . NBP count “ 0x03 ; /* interval and teiry count 7 
mppPB.NBPent1tyPtr = (ptr) *ntePtr: 
nppPB. NBP verify Flag ^ (char) true: /* unique name V 

result - PKeglsterName (6[iEppPB. false) : 

if ( result 1“ noErr ) 

DisposePtr{(Ptr) *ntePtr): 

I 

return ( result ); 

1 
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Note: DTS advises against applications searching the 
entire intranet for a matching entity. Such a search is time 
consLiniiiig. On a large network with many zones, you can 
spend substantial amounts of time doing this search. This 
would be not be considered reasonable in startup code. 
Instead, we advise that you search the local zone. If 
necessary, implement an asynchronous background search 
into the other zones. 

Thing You Shouldn't Do 

We discoumge you from trying to use special tracks on 
formatted floppies, or special floppies. Apple does not 
document the floppy drive sufficiently Un DTS to support such 
an aertion. Also, DiskCtjpy and other disk copying programs 
work very well at copying floppies, thus defeating such 
schemes. {DLskCopy was written inside Apple wtlh access to 
the .source of the flo[3py driver; we do not publish these details 
externally.) You should not rely on specific bizarre sectors of 
the hard disk (Apple relies on multiple vendors for iLs 
componenLs. You cannot make undocumented assumptions 
about a particular machine or class of machines.) 

Note: At some pthnt in flic future, Apple will create 
machines which do not support 800K GCR-formatted floppies. 
You should not depend upon specific hardware features such 
as 800K GCR formaiLing for copy protection purposes. 

CONtXLSION 

Copy protection is difficult to implement, and it is difficult 
to find a scheme which is not easily broken. 'I'he Mac OS was 
not designed with copy protection in mind, and there is no 
unique serial number available acros^s the entire set of Mac OS 
bast:d compulers. There arc some techniques which can be 
used to help differentiate between Mac OS compuLers, and 
these techniques are described in this article. 

Tlierc are many more sophisticated schemes for copy 
protection. If you are serious about copy protection, you 
should probably be contacaing one of flic many companies 
which specialize in such solutions, rather than writing a 
solution yourself. Both hardware solutions (such as ADR 
dongles) and software solutions (such as licensing software) 
are widely available from third parties, 

DTS does not support copy protection liecause of the 
significant compatibility liabilities it involves. DTS does not 
maintain expertise in copy protection techniques. 

FORllOiR REtTEBENCES 

1) Inside MacintosluDevices, 

2) ATA Device Software Guide. 

3) Inside Macintosh:Networking, chapter 3, Name Binding 
ProRxrol SCST-2 .spedfication. 
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Macintosh Q & A 


All Gf/>metry Vehtices Need UV PARAMETERiZATiorsi 
Q. Is it passible to apply UV pamnetcrLEatian to some, but 
not all of a geometry's vertices? 

A. No, you must apply UV pammetenzation to all of the vertices 
m a given geometry* 

Default Nimbbr Of Surface Pianes 
Q, When rendering a QuickDraw 3D 1.5 file containing 
«>h|ects such as cylinders and ellipsoids, the default 
number of surface planes is much higher than in 
QD3D version 1.0.6. While this looks nice, it requires 
more memory. Is there a way in my application io 
limit the 'resolution' (t.e. the number of surface 
pianes) used by QD3D 1.5? 

A. You can use a subdivision style to get control over tlie 
numlxrr of faces generated. For example^ you can create a 
subdivision style objea as follows: 

theSubdivisionSty1eData.method = 
kQ3SubdiviaionKethodSc reenSpace: 
theStibdlvlslonStyleData.cl " (float)20; 
theSubdlvislonStylcnata*c2 ^ {float)20: 
mSubdivlsionStyle = 

Q3S ub d i vi s 1 on S ty le_N ew (& theSiibd i vi s i on Sty 1 eDa t a J: 

You can then submit the subdivision style in your rendering 
loop before you sulimil your geometry, 

EutpsoidData Caps Field Explanadon 
Q. 1 am perplexed as to what the caps field in the 
lQ3EllipsoidData structure is used for. Can you explain? 

A. Here's an explanation. If you cut a pool ball in half, you get 
a solid hemisphere. If you cut a baskeilrall in lialf, you get a 
hollow hemisphere. Ihe intention of the caps is to specify 
which sort t)f a trail yrmVl like to pretend you're rendering. 
You will IN THE FUTURE (NOT for L5.1) be able to specify 
min and max parameter values, making partial ellipsoids 
(cones, etc.). When this feature is released, you can either 
leave the caps field value as none (kQ3EndCapNone), in 
which case you'll get a hollow-looking parlial sphere, cjr 


interior (kQ3EndCapMasklnleriorX in which case you'U get a 
solid-looking partial sphere. 

Using Hardware AtxitiJRRATiON 

Q. flow do 1 set up QuickDraw 3D hardware acceleration? 
is there any specific API calls I have to make? Or do^ 
hardware acceleration just work automatically if you 
liave a hardware accelerator ixiard installed? 

A. The QD3n interaaive tenderer automatically uses hardware 
acceleration if a card is present (and selects the best hardware 
if there are multiple cards). The wirefmme renderer does not. 

You can tell a renderer la use hardware acceleration with 
the Q3InteractiveKenderer_SeLPFefcrencesO and 
Q3View_SetKenderer functions* 

Check out the BoxPaint sample code from the QD3D SDK 
which uses the above functions to set the renderer 

Default Surface/Siiader UV Params For Caps of Dines 
&AMP; Cylinders 

Q. Does anyone know what the default sufface/shader UV 
parameterizations are for the caps of cones and 
cylinders tn QuickDraw 3D version 1,5? 

A. Check out the article tilled, “New QuickDraw 3D 
Geometries^ by Philip J, Schneider in develop journal issue 
28, Look for the section “Ellipsoids, Cones, Cylinders, and 
Tori", where you'll find a discu,ssion about the default UV 
parameterization of these primitives. Here's a relevant excerpt 
fn)m the article: “For the cone and cylinder, the parametric 
origin LS on the lx>Uom edge, al the point where the 
majorUadius veaor ends. V goes up while U goes around in 
ihe direction shown by the arrows. 'Ihe Ixittom of the cone, 
and die top and IxALotri of the cylinder, are parameterized 
exactly like the disk.” 

The discussion alxHii the disk primitive is in the article as well. 

m 
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□ Stock op on the latest *>oo 
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DE^TLOPMENT ENVIRONMENTS 




• Includes Windows 95/NT and Mac OS versions of the 
CodeWarrior IDE 

• Supports C, C++, Java and Pascal 

• Develop for Windows 95/NT on x86 and Mac OS on 
68K/PowerPC 

• New Project Manager supports multiple open projects, 
subprojects, multiple targets per project, and threaded execution 

• Integration of tools means you spend less time navigating and 
more time coding 

More platforms, more languages, more options: CodeWarrior 
Professional is designed to give you the tools you need for 
serious, industrial-strength programming. CodeWarrior 
Professional is the only Integrated Development Environment 
(IDE) in which you can edit, compile and debug C, C++, Java 
and Pascal programs for multiple target processors and 
operating systems. CodeWamor's compilers produce fast, highly 
optimized code lor Windows 95/NT running on x86, or Mac OS 
running on 68K or PowerPC processors. CodeWarrior 
Professional features the new CodeWarrior IDE Version 2. The 
newly revamped Project Manager supports multiple projects 
open simultaneously, multiple targets per project, and threaded 
execution, plus it's significantly faster. CodeWarrior Professional 
also includes online books, documentation, and reference 
materials, as well as tutorials and sample code. We support 
your development efforts with one free update and free world- 
class technical support for a year with registration. 

Upgrade for competitive product owners 
(SCWPRUP) Our Price $449 
Full Version 

(SCWPRO) Our Price $599 
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CodeWairior 
for BeOS 3 

by Metrowerks 


Be 

OS 


• Start programming for the new. innovative Be Operating 
System (BeOS) with complete set of Codewatrior tools 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax colw 
and styling, and a source-ievel debugger 

• BeOS header and libraries, complete documentation, usehji 
C++ classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program for 
the BeOS on a 603 or 604 PCI based PowerMac 


(SCWFB) Our Price $299 


/A 


metrowerks 



CodeWairior for 
PalmPilot 

by Metrowerks 



CodeWarrior for PalmPilot is the first complete set of tools which 
enables you to develop for the U.S. Robotics PalmPilot 
connected organizer, from the comfort of your PC or Macintosh 
computer. All the tools you need are included: the award¬ 
winning CodeWarrior IDE, compiler, linker, source-leve! 
debugger, GUI builder, and other toots, plus online 
documentation and reference materials. Includes one free 
product update and free technical support with registration. 
(SCWPALM) Our Price $369 


CodeWairior Latitude 

by Metrowerks 

Don't throw away the investment you have 
made in your Mac OS applications! With 
the DR/1 release of CodeWarrior Latitude, 
you can prepare your Macintosh 
applications to run native under Silicon 
Graphics IRIX or Sun Solaris (and soon, 

Rhapsody). Begin work now to prepare 
your Mac OS application to run native 
under Rhapsody. By compiling and linking your CodeWarrior project 
with the Latitude libraries, you can identify whici) portions of your 
code will port smoothly and which Mac Toolbox traps are not 
implemented. Additionally, you can expand the market for your Mac 
OS application by completely porting it to Silicon Graphics IRIX or 
Sun Solaris at a fraction of the cost of other porting tools. 

As the Rhapsody API evolves, so will Latitude. Registered users of 
CodeWarrior Latitude will receive all developer releases, the first full 
release, plus one additional product update, to ensure that you have 
access to the most up-to-date Rhapsody porting tools available. 
(SeWLAT) Our Price $399 


MW Visual SourceSafe 
Release 5 

by Metrowerks 

• Source code control system, plug-in 
to the CodeWarrior IDE or stand¬ 
alone Client application 

• Compatible with Microsoft Visual 
SourceSafe version 5.0 

• Cross-platform support (Mac, Windows, UNIX) 

• Configuration management in excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support 
and one free update 

(SMWVSS) Our Price $499 
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CodeWarrior 

Discover 

Programming 

Edition 

by Metrowerks 


• Leam to progtam in C/C++/Java/Pascal 

• Full-featured programming product - not a “lite" edition 

• Online books and tutorials 

• Hosted on either Mac OS or Windows 95/NT 
CodeWarrior Discover Programming Edition offers an unbeatable 
combination of full-featured programming tools, online books 
and instructional materials, all at a great price. Whettier you 
want to learn the basics of programming or add a new language 
to your skill set. Discover Programming puts the information and 
tools you need at your fingertips: the award-winning, easy-to- 
use CodeWarrior Integrated Development Environment (IDE), 
four of the most popular programming languages, online books, 
online tutorials, sample source code and free technical support 
(with your registration). Discover what you can leam with 
CodeWarrior, buy your copy today! 

(SCWDISCMAC) Mac OS Our Price $79 
(SCWDISCWI) WIN 95/NT Our Price $79 


Order Toll-free 
800-MACDEV.1 




^ Apple Dylan 


Apple Dylan Technology Release 

by Apple Computer, Inc. 

• Contains a PowerPC native prototype version of a development 
environment based on the Object Oriented Dynamic Language 
(OOOL) Dylan. Developers will be able to produce code targeting 
both 680x0 and Power Macintosh systems 

• Automatic memory management 

• Application framework and user-interface & builder 

• High-level exception haruJIing 

• Cross language support for C code and APIs 
CD & Online Documentation 

(SADTRO) Our Price $ 39.95 
CD & Hardcopy 

(SADTRH) Our Price $ 59.95 


Newton Toolkit 1.6 

by Apple Computer, Inc. 



With Newton Toolkit, you can easily crrate software that runs on any 
Newton PDA, including Apple's MessagePad and Motorola's Marco. 

• Now supports Newton 2.0 

• Dynamic Language Eases Development 

• Allows you develop applications interactively 

• New Compiler Enables Faster Applications 
Newton Toolkit 1.6 

(SNETO) Our Price $149 
Newton Toolkit Update 1.6 
(SNETOUP) Our Price $29 


Newton 


Newton Toolkit 1.6 for Windows 

by Apple Computer, Inc. 

With Newton Toolkit, you can easily create software that runs on 

any Nevirton OS device from Apple or its licensees. The Newton 

Toolkit is a development environment Itial reduces Ihe complexity 

and time involved in creating great software products. 

• Provides access to features specific to the Newton 2.0 OS - Allows 
developers to create new or modify existing Newton applications to 
take advantage of powerful Newton 2.0 OS features 

• Supports Windows 95, Windows NT 3.5x, and Windows 3.1(virith 
Win32s) operating systems -Enables developers to use multiple 
development environments/operaling systems when creating 
Newton applications 

• Includes Macintosh-to-Windows NTK project converter tool - 
Allows developers to automate conversion of existing NTK projects 
from Macintosh platform to Windows platform 

• Provides NS Debug Tools - Allows developers access to interactive 
Newton application debugging tools. Offers extended NcwtonScript 
debugging functions, which let developers study and manipulate 
an application running on a Newton device. Developers can use 
NS Debug Tools to set break points in an application after it's been 
compiled and installed, step through program execution, examine 
and change (Ejects on the Newton, and display a textual 
representation of the interpreter instmctlons 

(SNFTOW) Our Price $149 
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MkUnux: Microkemel 
Linux 

for the Power Macintosh 

by Prime Time Freeware 
MkLinux is a native port of Macb 3 and 
the Linux 2.0 kernel, complemented by hundreds of commands 
from BSD, GNU, and X11. It runs on most (NuBus abd OCU bus) 
Power Macintosh systems; Performa, PowerBook, and 
multiprocessor ports are cumently under development. 

MkLinux is robust, powerful, freely distributable, and source code 
compatible with most other Unux systems. It provides a full suite 
of development tools, support for AppleTalk, HFS. and Objective- 
C. and access to a vast amount of free software. MkLinux is a 
great way to “come up to speed" on Mach, UNIX, and Rhapsody. 

• MkLinux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Linux, Mach. NeXT, and 
the Power Macintosh 

■ Includes free 3.0 upgrade 
(BMKLINUX) Our Price $50 



VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 
Macintosh and Power Macintosh applications in standard BASIC code! 
VIP-BASIC 2.0 is the fastest way to program your Madntosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• Import pre-existing BASIC code; automatically integrate BASIC 
code, export C Code for compiling; automatically convert your 
BASIC code to C tor compilation with Metrowerks’ CodeWarrior 
(SVIPBASIC) Our Price $195 

Macintosh Common Lisp 4.0 

by Digitool, Inc. 

Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it e^ially 
well-suited for rapid prototyping, custom 
devetopmenl for business and education, 
scientific and engineering applications, and academic research. 

• Power PC native environment & compiler, full Macintosh support 



Check out our Web site! * 

• Full product descriptions • Hundreds of more products 

iittp://www.devdepot.com 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90. VAX compatible F77. and 
C/C-r-H compilers into a single, easy to use environment. Alt compilers 
are link compatible and operate through a common interface. 

■ Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C-m-, MrC and 
CodeWarrior 

• it is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 

Order Toll-free 
SOO-IUCDEV-I 

1(10)622 ueii 


ViP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger, Import pre¬ 
existing C code: automatically integrate C code with a current project 

• Includes full-featured mini database: (tld to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications 

(SVIPC) Our Price $295 


• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools. 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCUSP) Our Price $675 
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ObjectMaster 
Professional Edition 

by Altura Software, Inc. 

Object Master is an innovative programming environment that 
provides aii the necessary toois to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor avaiiabie 
on the desktop 

• Organize source code into projects to quickly access and 
manipuiate ali fiies 

• Navigate through source code using intuitive graphicai 
Browser windows 

(SOMPE) Our Price $399 



Roaster 

by Roaster Technologies, Inc. 

Roaster Release 3.1 is now available 

with JDK 1.1 and JavaBean support! 

Getthe most out of Sun’s Java™ 

programming language with this 

powerful development environment. 

• Features include: ability to build 
stand-alone Macintosh applications 
or applets; visual Interface builder; ability to create cross-piatform 
zip files; powerful Java debugger; wizard for quickly creating Java 
applets or applications; JavaBean support; JDBC support; Java 
object database included; ability to call AppleScripts from Java; 
Just-in-time (JIT) compiler; JDK 1.1 .x support; class tree and 
hierarchical class browser; much more! 

• Software includes; Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design’s PSE for 
Java; OpenLink Software’s JDBC Drivers; OpenSpace Java Generic 
Library; Microiine Component Toolkit Lite 3.0; much more! 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

• Price includes all web-based updates 
(SR0AST3) Our Price $99 



NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

■ Create files, access the built in 
input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from www.nsbasic.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Piso runs on MP 1201s with NOS 2.0 that 
have lull memory available 

■ Write short programs to access News, mail and the web 
(SNSBASiC) Our Price $99 



soups, and the serial port for 
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CodeBuilder 

by Tenon Intersystems 

CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 


• A powerful Macintosh software development tool suite of C, C-i-i-, 
Objective-C. Java. Ada. and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger tor Objective C. and 
C, C-h-t-, Ada 95 and Fortran 77 

• Web & internet scripting tools: Peri. MacPerl, telAk. bash, sh, and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) 0urPrice$149 


THere/ Here’s a list of all available products. For full product descriptions 
please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAO 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-in 

SLSFPI 

199.00 

Mac FORTRAN 1! 

SF0RT2 

595.00 

Power MachTen-UNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

SmailtalkAgents 

SSTA 

695.00 

Think Pascal 4.0 

SPASCAL 

165.00 



Web site: http://www.devdepof.com • E-mail: orders@devdepot.com 
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ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes lor integrating 
Internet e-mail in your applications 

• Helps you write software that 
can share mail with other leading 
e-mail products 

• Royalty-free MIME, SMTP, and 
POP3 APIs 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 

(SOSMSDK) 0urPrice$495 

r-tree Report Generator 

by Faircom 

Handles virtually every aspect of report 
generation: 

• Compiete C source 

• Complex multi-tine reports 

• Multi-file access 

• Complete layout control 

• Conditional page breaks 

• Nested Headers and Footers 

• Horizontal Repeats 
(SRTRG) Our Price $445 

Spellswell Plus 2.1 

by Working Software 

• Award winning, comprehensive, practical spelling checker that 
works in batch mode or within applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudora, WordPerfect, 
Communicate!, and InfoDepot) 

• Checks for spelling errors as well as common typos like 
capitalization errom, spaces before punctuation, double word 
errors, abbreviation errors, a/an befota vowel/consonant, etc. 

• MacTech orders include developer kit with Writeswell Jr, a sample 
/tppleEvents Word Services word-processor and its source code 

• Available for OEM Sales 
(SSPELL) Our Price $49 

c-iree Plus® Database Handler 

by Faircom 

Unsurpassed Cross Platform 
Tools for Mac Developers! 

• Full C Source 

• Client/server Option 

• Over 16 years proven 
reliability 

• Concurrent simultaneous access of Mac/PC files 

• Superior throughput and performance 
« Unparalleled scalability and flexibility 

• Fixed/Variable length files 
(SCTPDH) Our Price $895 





Memory Mine 

by Adianta inc. 

• Monitor heaps, identify 
problems such as 
memory leaks, and 
stress test applications 

• Active status of 
memory in a heap is 
sampled on the fly: 
allocation in non- 
relocatable (Ptr), 
relocatable (Handle) and 
free space is shown, as are heap corruption, fragmentation, 
and more 

• Allocate, Purge. Compact, and Zap memory lets users stress test 
all or part of a program 
(SMEMMINE) Our Price $99 


ScriptDemon 

by Royal Software, Inc. 

ScriptDemon is a browser plug-in that, for the first time, allows you 
to deliver and run AppleScripts from Web (rages. The ScriptDemon 
piug-in will execute tiie embedded AppleScript code included on a 
Web page. ScriptDemon painlessly and inexpensively handles many 
previously impossible tasks, such as; 

• Using the Intranet to manage all Macintosh computers on-line 

• Using the Internet to install and configure software 

• Using the Internet to configure hardware 

• Delivering complex sets of files and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 
Internet and Intranet 

• A perfect companion to LiveCard! 

(SSDEMON) Our Price $949 




Guide Composer" 1.2 

by StepUp Software 


STEP"'* I 

software] 


• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG developmeni environment: Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same forma! as the user 
will use them 

• Feature are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases. Coach marks, Fully-Integrated with Apple's 
Guide Maker (distributed witii Guide Ckrmposer), compiles scripts 
automatically. PICTs in Panels. Generated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http;//www.guideworks.com/ 

(SGCOMP) Our Price $99 

SEE RELATED PRODUCTS: AppleGiiide Complete, Danny Goodman's 

AppleGuide Starter Kit. Real World AppleGuide 
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VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version 
control tool for all sorts 
of projects (software 
development, 
documentation, design, CAO, publishing, etc.) 

• Smooth integration with Metrowerks CodeWarrior IDE 

• Simple and dear management of variants and revisions of entire 
projects (not only of single files) 

• Easy-to-use graphical project browser gives access to all versions 
that were ever stored, 

• Recording of the complete history (who made which changes 
when and why) 

• View differences between versions (not only for text files!) 

• Efficient delta storage of arbitrary files (text as well as non text 
files) gains savings of 95 % and more 

• Administration of users with hierarchical access rights 

• Configurable local file locking (Rnder flag or 'ckid' resource) 

■ Scriptable, essential parts PowerPC native 

Single license (SV00D001) $229 
2 pack (SVOOD002) $359 
5 pack (SV0OD005) $799 
10pack(SVOODOOlO) $1369 
20 pack (SV00D0020) $2399 

Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 




Spotlight 

by Onyx Technology, Inc. 

Spotlight Is a stand alone debugging aid that perfornhs memory 
protection (arays, heap accesses, outside your heap, low mem, 
etc), discipline checking on toolbox calls, and leaks detection. 

• Spotlight is sold on an annual subscription basts 

• The subscription service provides all updates 

• Includes maintenance releases for one year after 
the initial purchase or renewal date. 

(SSPTLT) Our Price $199 


AppSketcher 1.0 
for BeOS 

by BeatWare, Inc. 

AppSketcher is the premier 
programming tool for the BeOS. 

• The fastest way to deveiop software on the BeOS 

• Drag and drop design is great for creating user interfaces 

• Supports localization for worldwide sales 

• Expands applications easily without manual code 
modifications 

• Shortens development time by automating the Make process 
through direct communication with the BelDE 

(SASFB) Our Price $199 



StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional replacement for the List 
Manager used by developers woridwide. Version 3.0 is a new 
release with many improvements including better clipboard and 
drag/drop integration with other applications. 

• Available tor use with (todeWarrior C & Pascal 

• Includes libraries for 68K (A4 &A5) and PowerPC 

• An LTable-like class is provided to incorporate StoneTable into 
the PowerPlant environment 

(SSTONEFAT) 0urPrice$199 
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QC 

by Onyx Technology, Inc. 

High performance runtime stress 
testing for applications. 

• Tests include heap checks, 
purges, scrambles, 
handle/pointer validation, 
dispose/release checks, write to 

zero, de ■ reference zero as well _ 

as other tests like free memory 

invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 



Order Toll-free 
800-MACDEV-1 
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MacA&D 6.0 

by Excel Software 

• Structured analysis and design 

• Object-oriented analysis and design 

• Real-time and multi-task design 

• Data and screen modeling 

• Integrated code editing and browsing 

• Multi-user dictionary and requirements 

• Code to design diagrams tor C, 
C-r-r-.elc. 

• Design diagrams to code for C, 

C-T-r, etc. 

• State modeling diagrams and tables 

• Use cases witti (raccabilily 
(SMACADP) Our Price $1995 


Apprentice 6 

by Celesbn Company 



Apprentice 6 is a high-quality CD-ROM collection of over 600 
megabytes of up-to-date source code, utilities, and info for Mac 
programmers. All of the source code and utilities are completely 
new or updated for this release. 

• Frontier 4.1, the highly-acclaimed scripting environment 

• More PowerPlant AND many more PowerPC samples 

• Coo! new languages and environments added (Clean, Eiffel. F, 
Tcl-Tk) 

• Hot new demos from leading Mac development companies 
(SAPPRENT6) Our Price $35 
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SottPolish CD-ROM 

by Bare Bones Software 

• Ttie essential tool for software 
quality assurance on the 
Macintosh 

• Helps you identify 
inconsistencies with Apple’s user 
inteitace guidelines, misspelled 
words, missing resources, and 
other mistakes 

• Provides tools to put the finishing touches on software distribuBon 
packages prior to release 

• Works independentiy of any programming language or errvironment 

• Ideal for sanity dieddng software throughout the development process 
(SSOFTPOL) Our price $99 


Future Basic II 

by Staz Software 

FutureBASIC II is the award winning 
leader in Macintosh BASIC 
programming, 

• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi-file find and replace 

• Super fast compilaWon, 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 




AppMaker 

by Bowers Development 

• Develop the user interface for a 
Macintosh application using the 
original interface builder 

• Just point and click to design 
your application 

• Creates resources and generates 
excellent source code 

• Supports most development 
environments Including Metrowerks, Symantec, or MPW; C, 
C-I-I-, or Pascal; procedural or object-oriented, using 
PowerPlant, TCL, or MacApp 

• The generated code uses the Universal Headers to provide 
PowerMac compatibility 

• Great tool for beginners to learn object-oriented and 
Macintosh Toolbox programming techniques 

• Includes one-year subscription on CD and hardcopy 
docutnentation 

(SAPPMAKE) Our Price $299 



True relational database system for Apple Macintosh computers 
Pravides a powerful choice for developers who want to create 
database centered applications with no performance trade-offs 
Features SQL, full transaction control, error recovery, single user, 
client server architecture and multi-platform support including 
DOS, Windows, OS/2 and UNIX 

The C/C-i-H API is identical and fully portable across ail supported 
platforms 

Third-party vendors supporting dtF will be able to offer a variety of 
advanced features and benefits to their customers royalty free 
Tools are included for importing, expoiting, creating and managing 
databases and users 

Supported development environments include; Symantec, MPW, 
Metrowerks and more Mac/SDK 
(SDTF) Our Price $695 



B-IVee HELPER 2.2 

by Magreeable Software 

• Inexpensive datat3ase engine 
for Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts files when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less than, or greater than a given value 
in a few hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer “atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) Our Price $219 

ScrIptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstallerPack, Stuffit decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 
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Water's Edge Software 



Tools Plus libraries + framework 

by Water’s Edge Software 

Easily create compact, fast running, professional looking applications and 
plug-ins'. Tools Plus lets you create virtually any user interface element 
with a single routine, and it transparently provides a robust infrastmcture 
to make all your pieces work together as an application. Rated 4 stars by 
Macworld! MacTech (July 96); "it’s an incredibly rich collection ol toots... 
If you are interested in developing applications that have ‘quality’ written 
all over them, then Tools Plus is for you," 

• Simplities programming and thins source code 

• Automates all standard GUI elements 

• TTiousands of extras, from floating palettes and tool bars to 
powerful picture buttons 

• Includes numerous 3D grayscale options 

• Over 1/2 MB Of custom fonts, icons, cursors, and other resources 

• Includes SuperCDEFs world-class controls (an $89 value) free 
(STOOLCW) Our Price $249 

CkxleWarrior Gold (C/C-i-i- & Pascal. 68K & PPG) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C-r-i- & Pascal, 68K) 

(STOOLSYMT) Our Price $199 

Symantec (THINK) C/C++ and THINK Pascal (68K) 

(STOOLSYM) 0urPrice$149 
Symantec (THINK) C/C++ {68K) 

(STOOLPAS) Our Price $149 
THINK Pascal {68K) 

'CodeWarrior required to write plug-ins 



Order Toll4ree 
800-MACDEV.1 




Testihick-Bug 'nracking the Macintosh Way 

by Seapine Software, Inc. 


• Tracks bugs, feature requests, test configurations, users, and more 

• Includes notifications, security, a powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, dxumentations staff, and project 
managers together to ensure all bugs are identified, fixed, and 
documented 

• Eliminates the need to build custom bug tracking solutions using 
general purpose database tools 

• Supports single- and multi user bug databases (additional licenses 
required to use multi-user features) 

(STETB) Our Price $129 


CodeBuilder ’^TENON 

by Tenon Intersystems intersvsjems 

CodeBuilder is a powerful and unique Macintosh software 

development tool for porting existing apps or developing new, 

advanced applications on Power Macs and Power Mac clones, 

• A powerful Macintosh software development tool suite of C, C-h-h, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C. and 
C. C-r-t-, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tcl/tk, bash, sh, 
and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 

Phyla"*: Object-Oriented 
Database 

by Mainstay 

•Powerful Databases Without 
Programming; Phyla handles your all 
your complex database needs 
•Define a Database in Minutes; Using 
an intuitive, graphical user interface 
•Objects Are a More Natural Approach: 
Phyla creates real world databases 

• Orag-and-Drop Ease; Relate objects by simply dragging objects 
between windows 

• Create Custom Forms and Reports; Quickly create custom forms 
and reports 

• Fast Rnds and Sorts: Perform complex queries and calculations 
without programming 

• Synchronize Multiple Databases Copies 

• Password Protection With Access Limitations 

• Easy Import and Export; Import from other databases, export data 
in various formats 

(SPHYLA) Our Price $179 


BBEdit4.5 

by Bare Bones Software 

A powerful, easy-to-learn text 
editor. Adds new features for 
HTML coders, including a 
spelling checker and HTML tag 
palette. Accelerated for Power 
Macintosh: dragging supported everywhere; Internet Config 
aware: PowerTalk aware. Integrated support for Symantec’s 
IDE. Metrowerks CodeWarrior. THINK Reference 2.x, MPW 
ToolServer. and most other environments. Many UNIX style 
tools, including "grep’ searches, file comparisons, and sorting 
multi-file search and replace. PopUpFuncs feature lets you 
jump to a function from a menu. 

(SBBEDIT) OurPrice$119 




Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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CPU Doubler 

by Orchard Software 

• Performance enhancement utility 
for the Macintosh 

• Increases the speed of your 
computer by 100% 

• Works on both the PowerPC and 
68K Macintosh 

• Manages computer throughput 
using a proprietary scheduling 
algorithm 

• Ensure optimai performance and 
compatibiiity 

(SCPU2X) Our Price $79 


oUCT! 



SEE RELATED PRODUCTS: 

Development Environments 


Compilelt! 

by Royai Software, Inc. 

Compiieit!, the first HyperTaik compiier, is a complete deveiopement 
system lor the creation of XCMDs and XFCNs. 

• Expand the capabilities of your environment by using Compiieit! 
and the ROM Toolbox extensions 

• Increase the speed of routines written in HyperTalk by turning 
scripts Into externals 

• Protect sensative code from prying eyes because your code is 
now complied! 

• Easily learn Macintosh programming by exploring the ROM 
Toolbox 

• Includes Debugltl, a valuable source-level debugger for externals 
created with Compiieit! 

(SCOMPrn Our Price $149 



L .. 


DesignWorks 4.0 

by Capilano Computing 

DesignWorks 4.0 has all the ease 
of use and schematic editing 
power of previous versions, plus 
new features designed to make 
your entire design process easier 
and more error free. The 4.0 
version has new menu customization and scripting features that will 
directly address your design checking and interfacing needs. 

• Flexible schematic editing features speed the drawing process 

• Full Undo/Redo on all editing operations 

• Hierarchical design with unlimited levels is fully supported 

• Powerful attribute features allow arbitrary text information to be 
associated with any signal, device or device pin 

• Extensive symbol libraries with over 12.000 parts in ANSI and 
IEEE format 

• Integrated device symbol editor allows you to create custom 
symbols using standard drawing tools 

• Interactive digital simulator option is available. No netlists, no 
application switching! 

(SDWORKS) Our Price $995 




EUierPeeK 

by AG Group, Inc. 

EtherPeek for Macintosh is a full-featured 
pnotocoi analyzer that allows you to quickly 
and easily test and debug network communication, and: 

• Check for protocol compliance 

• Use hundreds of built-in decodes 

• Develop custom packet decoders 

• RIter packets during or after capture 

• Test device reactions to specific packet types 

• Customize or alter packets for transmission 

• Generate traffic to test varying loads 
(SEPEEK) Our Price $745 




OpenGL for 
the Macintosh 

by Conix Graphics 

OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 30 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhanc« ttie development of ail graphics software: 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling translormations 

• Texture Mapping, l.ighting. Shading and Z Buffering 

• Atmospheric Effects (fog. smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing. Accumulation Buffer. Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-uniform rational B-splines) 

• Feedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations (storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 



vrext 

by Vivistar 

VText is a C+4 add-on library for 
Metrowerks’ PowerPlant application 
framework. VText provides complete 
Macintosh text support including: greater 
than 32kb text, undo, drag and drop editing. 
AppleEvent scripting and recordability, full 
support for multibyte characters and inline 
input methods including Japanese and Chinese text, and full support 
for bi-directional script systems including Arabic and Hebrew. 

• Full featured text engine for Metrowerks' PowerPlant 

• Stylesets and rulersets with tabs 

• Flexible object oriented C++ API 

• Full undo and drag and drop editing 

• WorldScrlpt savvy including bidirectional and multibyte scripts with 
inline editing 

• AppleEvent factored tor scriptabiiity and recordabili^ 

(SVTiXT) Our Price $349 
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QUED/IUI 3.0 

by Nisus Software 

• The programmer's text editor that defined the 
industry standard for speed and efficiency 

• PowerPC native 

• Features integrated support for Symantec 
C/C++, Metrowerks CodeWarrior 6, and MPW 

• Supports all the major development environments on the Macintosh. 

• Powerful editing features, including unlimited undo and redo, macro 
language, scripting, text folding, ten editable/appendable clipboards, 
markers, displaying text as ASCII codes, dynamic coloring of C/C++ 
keywords/comments, rectangular and non-rantiguous selection 

• Includes Celestin Company's APPREMTICE 4 
(SQUEDM) Our Price $89 


AG Author 

by Lakewood Software 

AG Author 1.0 is a fuH-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author; 

• Support for styled, colored, & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

■ Multiple open projects 

■ Rapid deployment of praject globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS: AppJeGulde Ccxnplete, Danny Goodman’s 
AppleGuide Starter Kit, Real World AppleGuide 




Bee-one 

by Power Box 

Bee-one lightens your load on the road by 
adapting relational databases developed 
under 4D" to the Newton Platform. Once 
the program is installed on both the 
Macintosh and the Newton, it takes 4 
simple steps to use Bee-one! 

• Database transfer, Set-up, Use, and Synchronization 
(SBEEONE) Our Price $139 


Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and templates 
for building your own Web Page. An incredible 
selection of Shockwave movies, animated GIFs, 
buttons, bullets, dividers, and sample HTML pages. 
There are literally thousands of graphical elements on this disc, all there 
to spice up your web page. In all. it's about 300 megabytes of creativity 
only a mouse-ctick away! System Requirements: PC - 486 or better with 
8 MB RAM. Sound card. SuperVGA, CD-ROM drive. Macintr^ - Color 
Mac with 8 MB RAM, CD-ROM drive. 





(SWEBW) Our Price $24 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

Fortran 77 SDK 
ICONIX PowerTools-10 Pack 
ICONIX PowerTools-6 Pack 
ICONIX PowerTools 8 Pack 
ICONIX PowerTools-AdaFlow 
ICONIX PowerTools-ASCIl Bridge 
ICONIX PowerTools-CoCoPro 
ICONIX PowerTools-DataModeler 
ICONIX PowerTools-FastTask 
ICONIX PowerTools-FreePlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerTools-QuickChart 
ICONIX PowerTools SmartChart 
ICONIX Training & Consulting 
IMSL Math and Stat Library 
Info-Mac X 

Ionizer Real-Fime Spectral Reshaping Tool 
LiveAccess^” 1 User Edition 
LiveAccess™ 1 Developer Edition 
LiveCard 
U Profiler 

MacFlow'": Flowchart Design and Development 
Mac Source II 
Nisus Writer 5.0 

Plan & Track^“: Project Planning and Management 
Screen Machine 
Spyer 
Visual Cate 


CODE 

OUR PRICE 

SF77 

699.00 

SICPP10 

7,845.00 

SICPP6 

5,945.00 

SICPP8 

6,945.00 

SICAOA 

1,395.00 

SICASCll 

1,395.00 

SICCOCO 

1,395.00 

SICDATAMOD 

1,395.00 

SICFASTTASK 

1,395.00 

SICFREEFL 

1,395.00 

SICOBJMOD 

1,395.00 

SICPOWER 

1,395.00 

SICQUICKCH 

1,395.00 

SICSMART 

1,395.00 

TICONIX 

2,945.00 

SIMSLSTAT 

495.00 

SINFOMACIO 

39.95 

SIONIZER 

800.00 

SLAUE 

69.00 

SLADE 

99.00 

SLCARD 

149.00 

SUPROF 

295.00 

SMACFLO 

179.00 

SMACSOURCE 

29.95 

SNISUSW 

220.00 

SPLNTRK 

179.00 

SSM 

24.00 

SSPY 

39.00 

SVCAFEMAC 

199.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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WebTen 

by Tenon 
Intersystems 

WebTen is an 
industt^ial-strength, 
high-performance 
Apache Web server for 
Power Macs. WebTen’s 
Web-based browser 
interface enabies iocal 
or remote administration via your favorite browser. Since Apple’s NeXT 
acquistlon, Tenon has extended their unique “UNIX virtual machine” 
technology to produce a set of “Rhapsody-Ready" internet 
applications. WebTen Is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10.000 connections a minute, or over 10 mtiiion 
connections a day 

• Apache runs in Tenon’s multi-threaded, pre-emptive 
muititasking environment 

• Tenon’s unique technofogy supports the wideiy acciaimed Apache 
Web server as a doubte-ciickabie Macintosh application 
(SWEBTEN) Our Price $495 


OOFILE Reporter Writer 

by A.D. Software 

• Full embedded report-writer, allows you to preview page-by-page 
and either print or save as plain text, HTML or RTF 

• Multiple levels of breaks, database views, headers and footers are 
provided using a clean object-oriented design 

• Incudes RAM-based version of OOFILE database, included in full 
OOFILE Platform Bundle 

• Saving to file without preview of printing is cross-platform-run on 
your Mac/Win/UnIx server and creates web pages 

• Price includes 1-year subscription 
(SOORW) Our Price $499 



WebSiphon 

by Purity Software, Inc, 

WebSiphon is one of the most 
anticipated new CGI products for 
Macintosh Webmasters delivering a 
complete authoring tool for truly 
revolutionary sites. This product 
aione can replace most all CGIs on 
your site resulting in increased dynamic serving speed, 
reliability, and powerful scripting and database abilities directly 
within your HTML pages! Also includes Verona, the fastest flat- 
file database server available tor Macintosh web sites. 


(SWSIPHON) Our Price $495 


PageCliarnier: Sizzling Effects... 



PageChaimer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets ffiat 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES: 

LiveG-Map, LiveT-Map. LiveG-Button, LiveTButton, LiveGT-Button, 
UveG-Ticker, LiveT-Ticker. LiveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) OurPrice$139 


BBEdit4.5 

by Bare Bones 
Software 

A powerful, easy-to- 
learn text editor. Adds 
new features for HTML 
coders, including a 
spelling checker and 
HTML tag palette. 
Accelerated for Power Macintosh; dragging supported 
everywhere; Internet Config aware; PowerTalk aware. 
Integrated support for Symantec's IDE. Metrowerte 
CodeWarrior, THINK Reference 2.x, MPW ToolServer, and most 
other environments. Many UNIX style tools, including “grep" 
searches, file comparia)ns. and sorting multi-file search and 
replace. PopUpFuncs feature lets you jump to a function from 
a menu. 

(SBBEDfT) Our Price $119 



ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C-I-+ classes for integrating 
inlemet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mail products 

• Royalty-free MIME. SMTP, arid POP3 APIs 
for Macintosh. Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 
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Order Toll-free 
800-MACDEV-1 


(800622-338II 


Roaster 

by Roaster Technologies, Inc. 

Roaster Release 3.1 is now available with JDK 1.1 and JavaBean 

support! Gel ihe most out of Sun's Java™ programming language 

with this powertul development environment. 

• Features include; abilily to build stand-alone Macintosh 
applications or applets; visual interface builder; ability to create 
cross-platform zip files; powerful Java debugger; wizard for quickly 
creating Java applets or applications; JavaBean support; JDBC 
support; Java object database included; ability to call AppleScripts 
from Java; Just-in-time (JfT) compiler; JDK 1.1.x support; class 
tree and hierarchical class browser; much more! 

• Software includes: Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design’s PSE tor 
Java; OpenLink Software's JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3.0; much more! 

• Requirements; Runs on 68k or PowerPC. CD-ROM 

• Price Includes all web-based updates 
(SR0AST3) Our Price $99 


Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

ol Unix to your desktop at an extremely attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW, FTP, NFS, 
DNS and print sen/ice 

• Build a Mutihomed Web Server 

■ Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada. C, C-i-i-, Pascal. Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run SoftwatB.com Inc's acclaimed Post-Office mail transport service 
(SM10PPC) Our Price $695 


Web site: http://www.devdepot.com • 
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Rumpus 

by Maxum Development 

Maxum’s new, high- 
performance FTP server for 
the MacOS. Based on 

Maxum’s RushHourTCPAP implementation. Rumpus 1.0.1 offers 

the performance and reliability of high-end workstations with the 

ease of use. security, and flexibility of the Macintosh. 

• Simplified setup, with no need to configure AppleShare. RIe 
Sharing, or Users & Groups for simple anonymous FTP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBinary and Btnhex encoding 

• Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) Our Price $195 


ScriptDemon 

by Royal Software, Inc. 

ScriplOemon is a browser plug-in that, for the lirst time, allows you to 
deliver and run AppleScripts from Web pages. The ScriptDemon plug¬ 
in will execute the embedded AppleScript code included on a Web 
page. ScriptDemon painlessly and inexpensively handles many 
previously impossible tasks, such as: 

• Using the Intranet to manage all Macintosh computers on-line 
« Using the Internet to install and configure software 

• Using the Internet to configure hardware 

■ Delivering complex sets of files and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 
Internet and Intranet 

• A perfect companion to LiveCard! 

(SSDEMON) Our Price $949 


CGi Toolkit 

by Pictorius Inc. 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs 
and ACGIs for your Mac Web site. 

•Interactively develop CGIs while the 
web server, the CGt Toolkit and the browser are mnning on the 
same machine 

Interactively develop, test and debug CGIs before compiling 
Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 
Fully object oriented so you can re-use your code 
Automatic handling of Apple Events so you can concentrate on 
building functionality 

Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 
(SCGITLKT) Our Price $149 





E-mail: orders@devdepot.com 
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FaceSpan v2.1 

by Digital Technology International 

•Develop integrated software, make stand 
alone applications, create friendly 
interfaces 

•Develop quick prototypes, print multiple 
pages with sophisticated layouts 
•Script essential elements of the FaceSpan 
application • Enhanced save options 

• Play and record sounds as either “snd’’ resources or as “AiFF” files 

• Create miniature or complete apps that run on either Power PC or 
68k computers 

• Use precise time measurement for implementing timed behaviors 
— New properties 

• Proportionally scale PICT images -Align images in a pictbox - 
Automate any application 

• Monitor and respond to low-memory sHuations-increased support 
for Frontier UserTalk! 

(SFACESPAN) Our Price $299 


PreFab Player 

by PreFab Software, Inc. 

PreFab Player is a faceless background application (similar to a 
system extension) that lets your scripts query and control otherwise 
non-scriptable applications, desk accessories and control panels. 
Player adds verbs that directly manipulate the Macintosh user 
interface: choose from menus & pop-ups. select radio buttons, type 



AppleScript Software 
Development Toolkit 1.1 

by /^ple Computer, Inc. 

• AppleScript language, system software 
extension, and script editor 

• FaceSpan t.O 

• Developer’s redistribution license for , 
AppleScript System software extension 
and FaceSpan runtime code 

(SASDT) Our Price $49 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 

features a graphical view of objects provided by scriptable 
applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDE8UG) Our Price $129 


JM-. 



, j text, determine the name of the frontmost window, the state of a 
check box. etc. Balloon help identifies non-standard dialog items. 

• Adds verbs to AppleScript and to Frontiers UserTalk 


• Controls the Frontmost Application 

♦ 

0 

1 • Balloons Identity User Interface Objects 

• 

■ (SPLAYER) Our Price $95 

m 

• 
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TCP/IP 

Scripting Additton 



by Main Event Software 
For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice. Scripter! 

• Scripter and FaceSpan work together: one 
click opens your FaceSpan script in 
Scripter, another sends it back 
Debug handlers without modifying your scripts using the Call Box 
Applet simulation, live editing. Object map, associated terminology 
Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 
Now Includes ScriptBase; stores your data and media elements 
and share them between scripts all with a special new browser 
Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 
Scripter is the natural companion to AppleScript for users at alt 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 


TCP/IP Scripting Addition 

by Mango Tree Software 
•Award-winning AppleScript scripting 
addition 

•Allows you to write scripts using 
MacTCP™ commands in AppleScript'" 
•Send e-mail or fifes through a script, 
check if users are logged on (via Finger), automate FTP, Gopher, 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/IP client-server programs 
• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 


WindowScript 

by Royal Software, fnc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Real ’’Macintosh" user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript 
you can literally bring the look and teel of a real Macintosh user- 
inteftace to HyperCard. If you’re a HyperCard developer, interface 
designer, ^plication developer, program manager or tester 
searching for a pmtofyping tool, WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 



14 1-800-MACDEV-l • Outside U.S, & Canada: 805-494-9797 • Fax: 805-494-9798 
















Apple Media Tool Programming Environment 2.1 Multimedia Authoring with Apple Media Tool 

by Apple Computer, Inc. by Apple Computer, Inc. 


This object-oriented language and application framewor1< allows 
programmers to customize features used within the Apple Media 
Tool authoring environment 

Includes an expanded Apple Media Language (AML) class library, 
incremental compiling and linking of AML code, faster debugging 
facilities, Macintosh Programmers' Workshop (MPW), and user oriented 
documentation written from an AMTPE developer's perspective 
Portable across 68K. Power Macintosh, and Windows platforms 
(SAMTPE) Our Price $995 


Apple Media Tool offers new multimedia users a way to get started 
creating interactive multimedia with minimal learning time. This self- 
paced tutorial will make Apple Media Tool (AMT^ even easier to 
understand and to use. Using this tutorial, you will create a realistic 
multimedia project using exciting techniques such as QuickTime 
movies, animation and more. A demo version of AMT is included and 
can be used for the exercises. Training Format; Tutorial with labs. 
(SMWAMT) Our Price $49.95 



Virtual Reality 

Programming 

with QuickTime VR 2.0 

by Apple Computer, Inc. 

• Virtual Reality Programming Book/CD-ROM 
for QuickTime VR 2.0 

• Enables you to write C and C++ programs 
using QuickTime VR 2.0 

• Allows QuickTime VR to be used in 
games, multimedia titles and other 
programs 

• QuickTime VR 2.0 objects can be zoomed 
in on, parvied, or linked with hots spots 

• Both panoramas and objects have hot 
spots linked to World Wide Web URLs 
(SVRPOT) Our Price $49 


QuickTime Developer^s Kit 2.0 

by Apple Computer, Inc. 

• QuickTime 2.0 Extension. QuickTime Power 
Macintosh Extension, and QuickTime 
Musical Instruments extension 

• Utilities like MoviePlayer 2.0.16-bit Audio 
Compression, etc. 

• Sample content such as MPEG Movies, 
Music Movies, Time-Code Movies, and 60 
field per second movies 

• Includes software-only playback features 
such as faster 2x playback mode for 
current compressors. Apple Cinepak 
compressor. 1 -bit fast dithering, network 
tuning, load-into-RAM option, and Photo 
CD support 

(SQTDK) Our Price $99 



Clip VR" 

by eVox Productions 
Clip VR" is a new digital image library 
offering high quality Photographic Virtual 
Reality (PVR) images for use with Quicktime* 

VR and other desktop VR tools. 

ClipVR "* Panoramic Image components InciiKte 
alpha channel masks. Combine elements into a 
composite panaama which is converted to the 
finished QuickTime VR movie using Make QTVR 
Panorama Tool. The Components (“Clips") 
include complete 360 degree scenes, 
libraries of 360 degree terrains, 360 degree 
skies, buildings, and objects. Images are 
provided as .PICT files AND QuickTime VR 
movie filK. Clip VR™ allows you to create 
high quality VR worlds from pre¬ 
photographed component images. Clip VR™ 
can be used to add excitement to a web site, 
to increase the interactive value of a CD- 
ROM, or simply tor fun! Requires imaging 
editing program such as Adobe Photoshop " i 
to perform .PICT image compositing. 

(SCLIPVR) Our Price $89.95 


QuickTime VR 2.0 
Authoring Tools Suite 

by Apple Computer, Inc. 

• QuickTime VR is a cross-platform software 
from Apple which enables webpage 
designers and professional developers to 
create new multimedia products and 
webpages incorporating QuickTime VR 
content. With QuickTime VR. users 
interactively navigate through 360° views 
of space, and explore three dimensional 
objects on Macintosh or Windows-based 
personal computers 

• The QuickTime VR Authoring Tools Suite is 
a set of Macintosh tools to create and link 
panoramas and objects from 


photographic, digital, video, or computer 
generated images 

• Included Is a complete set of 
documentation for planning, designing, 
ptiotographing, and creating QuickTime VR 
panoramas and objects. The authoring 
tools also allow you to link objects to 
panoramas using clickable hot spots 

Included on the CDs are; 

• A software tool (MPW-based) that stitches 
and blends adjacent images into a 
panoramic PICT file 

• A software tool (MPW-based) that dices 
and compresses panoramic PICT files to 
less than 100 KB [low resolution) per 
panorama 


• A scene editor (HyperCard-based) to 
create QuickTime VR scenes by adding 
and positioning nodes, hot spots, linking 
nodes together, and for linking QuickTime 
VR objects to scenes 

■ A variety ot utility tools for formatting the 
data into the runtime software 

Due to a revolutionary distortion-correcting 
algorithm. QuickTime VR panoramas and 
objects maintain a norma! perspective when 
the user moves the mouse. The speed of the 
algorithm allows up to 24-bit color images. 
Both verticaf and horizontal panning can 
occur at fast speeds. 

(SQTVRATS) Our Price $395 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Media Cleaner Pro 

by Terran Interactive 

Use Media Cleaner Pro 2.0 to optimize and compress video for 
CD-ROM. kiosk, or the Internet. Media Cleaner Pro automates 
your work flow allowing you to get the highest quality video, 
faster and easier than any other program on the market. 

• Includes Adobe Premiere Export module 

• Optimal palette generation, Drag-and-drop batch processing 

• RealMedia, VDOUve and improved QuickTime support 

• Dynamic Preview Window, the Media Wizard, multiprocessor 
support and more! 


Captivate 4.6: 

Essential Graphics Utilities 

by Mainstay 

Captivate^” 4.6 is a powerful collection of 
graphics utilities for Macintosh, based on 
Mainstay's acclaimed screen capture utility, 
graphics and multimedia scrapbook, and 
graphics viewer. Captivate provides essential graphics utilities to the 
professional and hobbyist alike. 

• Pad<age includes: Captivate Select, Captivate View, and Captivate Store 

• Any one of file three can be used alone, and together they make 
an unbeatable team 

• Whether writing a training manual, creating an ad, or just creating 
a startup screen from your favorite picture, Captivate is everything 
professionals need at a price anyone can afford. 

(SCAPTIV) Our Price $79 



System Requirements: 

68040 Mac or better (PowerPC strongly recommended, req'd tor 
RealMedia), QuickTime 2.0 or later (2.5 strongly recommended) 

8 Mb application RAM. MacOS 7.0.1 (7.5 or later recommended) / . i 

SoundManager 3.2, CD-ROM Drive ^ ul^ V 

(SMCP) Our Price $359 aboutjH|r 

Registered owners of Movie Cleaner Pro 1.3 or earlier can upgrade ^ 

(SMCPUP) Our Price $129 


(SMT) Our Price $24 

Order Toll-free 
800-MACDEV.1 

|80()62233811 


MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new/^dio multimedia music CD-ROM for the 
Macintosh. This disc is a coilection of clips ideal tor Desktop 
Presentations and other Multimedia applications. This incredible 
coilection of license-free media clips is bursting with 240-i- color pictures and backdrops (PICT), 
200+ sound & mu^ clips (SoundEdit), 140+ QuickTime movies, and a variety of multimedia 
tools for use with the Macintosh. 

(SMWMC) Our Pace $24 




Music Ikacks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music CD-ROM. The clips include 
musical introductions, fanfares, background music, and more. This 
coilection oflers you 100 music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royalty-free!! Mac System requirements: Mac Plus or greater, CD-ROM drive. PC 
system requirements: Windows 3.1 or later, Sound Blaster compatible board, CD-ROM drive. 


Audiollrack 

by WAVES 

AudioTrack is a 
software plug-in for 
native processing on 
digital audio 
recording and editing 
systems. Waves 
AudioTrack combines the most-needed audio 
processors Into a single piece of software, 
including 4 bands of equalization, 
compression/expanston, and noise gating. 
AudioTrack is ideal for preparing audio for 
InterNet streaming formats, processing 
individual mono/stereo tracks of audio and 
audio for video editing systems including 
digital sequencers. 

Feature list 

• A single window interface 

• 4-band ParaGraphic Equalizer, 
Compressor/Expander and Gate 

• Instantaneous A/B comparisons of on-line 
settings 

• Pretested setup libraries supplied for 
various processing solutions 

• Power Macintosh native processing 
(requiring no DSP board) 

• Volume and gain reduction meters 

• Peak hold and clip meters 

Requirements; 

The AudioTrack is compatible with all 
machines supported by Deck II, SoundEdit 16, 
Adobe Premiere 4.0 and Cubase VST 3.1 
(SAUDIOTRK) Our Price $270 
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Casino! 

by BeachWare, Inc. 

Can't make it to Vegas this month? Your 
best bet is Casino! Whether your fawtite is 
Slots, Poker, Blackjack, or Keno, this wrtual 
casino wiil entertain you for hours with its 
ten different machines. Mac System 
requirements: Coior Mac. CD-ROM drive, 4 MB of RAM. PC system 
requirements; Windows 3.1 or iater, CD-ROM drive, 4 MB of RAM. 
(SCAS) Our Price $24 



Abuse 

by Bungie Software 

Abuse is 360 degrees of side-scroiling action. 

Run, jump, faii and fly In any direction - through 
industrial corridors, caverns and sewers. Destroy 
enemies in any direction with grenade iaunchers. 
rocket iaunr^ers, napaim and nova ^heresl Avoid 
deadly traps with jet packs and turbo boost! 

Key Features; 

• Make your own mayhem with the Levei Editor 

• Hunt down your friends in 8-pers(m multipiayer games 

• Awesome Arsenal. Napalm Bombs, Nova Spheres and the Death Saber: 
just a few ways to lay waste! 

• Point and Kill Interface. Move and annihilafe mutants in complete 360° freedom 

• Blast your way through floors, walls and ceilings In search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action. Run, jump, fall and fly in 
any direction - through industrial corridors, caverns and sewers 

• Destroy enemies in any direction with grenade launchers, rocket 
launchers, napaim and nova spheres! Avoid deadly traps with jet packs 
and turbo boost! 

(SABUSE) Our Price $51 



1000 Gaines for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire wald, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart run away asteroids, deal yourself toat royal flush or 
solve that 3-0 puzzle, this disc has if all! System requirements; Mac 
Plus or greater, CD-ROM drive, and 2 MB of available RAM (4 MB of 
RAM when running under System 7). 

(STGM) Our Price $24 



Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, 
redone with killer graphics and sounds! Walk 
through a virtual arcade and test your game 
playing skills with these exciting arcade 
classics. Ten games, including Moon Lander, 
Astro-Boing, Hyper Hockey, Ballistic Avenger, and more. System 
Requirements: Mac - Color Mac with 8 MB RAM. CD-ROM drive. PC 
486 with 8 MB RAM, Sound card, SuperVGA,CD-ROM drive. 

(SCLA) Our Price $24 
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Marathon IHIogy Box Set 

by Bungie Software 

The Marathon Trilogy Box Set brings all three 
Marathon games together In one affordable package, 
with tons of extras thrown in. Besides Marathon, 
Marathon 2: Durandal and Marathon Infinity, you'll 
also receive a staggering 1200 maps, featuring 
never-released Bungie maps and the winners of the 
Infinity Mapmaking Contest. The Marathon Scrapbook 
(a behind-the-scenes look at themaking of the Marathon games], Marathon 
collectables like the Marathon 3-sticker set, and to top it off. the award 
winning game that laid the gmundwork for Marathon: Bungle's breal#rough 
Pathways Into Darkness. 

The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 anti 24-bit color 
capable, and can be played with joysticks and game pads. The package 
requires a 68040 or higher Macintosh,CD-ROM drive, 8-hit color monitor 
(13“ recommended), and System 7 or later. 

(SMTBS) Our Price $^ 


Bivia Warehouse 2000 

by BeachWare, Inc. 

Introducing a fun new PC and Mac CD- 
ROM. This disc contains two thousand 
trivia questions, in 45 categories, in 
several game formats! Test your memory 
with the Q&A, Concentration, and Multiple 
Choice games! Categories include: 
Animals, Bodies, Bond. Bugs, Cities, Comics, Geography. Gilligan, 
Gross, Health, Holidays, Horrors, Kids, Knot's Landing, Math, Movies, 
and many more. Mac System requirements: Color Mac, CD-ROM 
drive, 4 MB of RAM. PC system requirements: Windows 3.1 or later, 
CD-ROM drive, 4 MB of RAM. 

{STW2K) Our Price $24 
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Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

A Ztllion Sounds SAZS 24.00 

Night Sky Interactive SNSI 24.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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I A System 7.5 Technologies 

I I spmT-i S by Apple Computer, Ina 

• Self-paced course designed to allow 
software developers to write code that 
extends the functionality of an application 
tor System 7.5 

• Contains comprehensive materials for drag-and-drop, threads, 
standard mail package, and QuickDraw GX printing 


Students should be familiar with the basics of developing an 
application on the Macintosh. Metrowerks CodeWarrior Lite is 
included on the CD with the lab exercises. The lab assignments were 
developed in CodeWarrior 8. The labs can also be done in another 
development environment but project files lor ftiem are not provided. 


Training Format: Tutorial with labs. 

Requirements; Macintosh or Mac-OS compatible computer with a 
68020 processor or greater (PowerPC preferred); 8 MB RAM; 25 
MB hard disk space: System 7.5 or later; CD-ROM drive. 


Apple Guide Integration 

by Apple Computer, Inc. 

• Self-paced overview teaches you when and 
how to add Apple Guide help to your program. 

• Powerful help system that can guide the 
user through a task. 

• Tutorial will lead you through the steps necessary to integrate 
Apple Guide into your application. CodeWarrior Lite is included on 
the CD with the lab exercises. 

Training Format Overview with labs. 

Requirements: Macintosh or Mac-OS compatible computer with 
68020 processor or greater, PowerPC preferred: 8 MB RAM; 25 MB 
hard disk; System 7.5 or later; CD ROM drive. 

(SAGI) Our Price $49.95 



(SSYSTECH) Our Price $49.95 


Virtual lUtor for QuickTime VR 


Q 



by Apple Computer, Inc. 

• Self-paced, hands-on course, which 
provides a comprehensive environment for 
learning the steps of the QTVR 
development process. The student can 
cover all of the topics or choose areas to 
focus on. Topics covered include; QTVR 
capabilities and key concepts, panoramic 
movies, object movies, QTVR Scene 
movies and authoring with QTVR 

• CD-ROM contains lots of useful examples 
and demos. In addition to all the step-by- 
step exercise files 


If the student completes the entire course, 
he/she will create a complete, authored 
multimedia project similar to the 
demonstration title that comes on the 
enclosed CD-ROM. There are approximately 
3-4 days of training. 

Training Format: Tutorial with labs. 

Requirements: 40 MB RAM minimum, 64 
MB preferred; Macintosh or Mac OS- 
compatible computer with a 33 MHz 68040 
prxessofor greater; System 7.1 or later; 
CD-ROM drive; 17” color monitor. 
(SVTFQTVR) Our Price $79.95 



Apple’s develop’” 
back issues are 
available for only 
$10 per copy. 

To place your 
orders, cal! 

800/MACDEV-1. 



ITrirTihUft 

& Orrtfnprrt 

MadIM' 

MAGAZINE 

MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with 
everything they need to know about software development. Topics 
like Rhapsody, Java, QuickTime, OPENSTEP, Objective-C, C/C++, 
Object Oriented Technologies, product reviews and much more! 
Subscriptions; 

(MTYRDM) L)S/Dome.stic for 12 issues $47 

(MIYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues: each plus shipping (subject to availability) $10 
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metrowerks 


GeekWare~ 

You live it, you breath it... you 
might as well wear it! (XL only) 



Alien T-Shirt 

(AAUEN) Our Price $9.95 
Arnold T-Shirt 

(ACWARNLD) Our Price $9.95 

Arnold Jr. T-Shirt 

(AARNOLDJR) Our Price $9.95 

Blood, Sweat & Code T-Shirt (SS) 

{ACWSBLOOD) Our Price $9.95 

Blood, Sweat & Code T-Shirt (LS) 

(ACWLBLOOD) Our Price $14.95 

CodeWarrior Baseball Cap - Black 

(ACWBHAT) Our Price $14.95 

CodeWarrior Sweatshirt - Black 

(ACWSWtAT) Our Price $29.95 

CodeWarrior Hawaii Five-0 Shirt 

(ACWHAWAII) Our Price $9.95 

CodeWarrior Winter Hat 

(AWINHAT) Our Price $14.95 

Debugger Boxer Shorts 

(ADBOXER) Our Price $16.95 

Discover Programming T-Shirt 

(ADISCPT) Our Price $9.95 



MacTech® Mouse Pad 

Slide on this! With an exVa-large surface (If by 10") and 
a deluxe sleek plastic coating, you’ll be zooming across 
your screen in no time at all. Speed limit not enforced! 
(AMTPAD) Our Price $8.95 


Podeum Sport 

by Rach, Inc. 

Now you can have laptop stability, drop 
protection & mobility. If you're looking 
for an inexpensive, non-technical gift 
for a laptop owner - look no further. 

• Strap your laptop to your leg 

• Universal size - fits all laptops and 
all legs (13"-46") 

• Velcro Velcoins attach your laptop to the podeum 

• Podeum allows working angles up to 90 degrees 

• Dropped laptops account for 41% of all laptop fatalities 

• Manufacturer’s lifetime warranty. 

(APODSP) Our Price $39 
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Getting Started With WebObjects 

by NeXT Software, Inc. 

If you're a first time user, start here to learn the basics of how to 
create and run WebObjects applications, 

(BGSWO) Our Price $14 

WebObjects Deveioper's Guide 

by NeXT Software, Inc. 

A guide to building and understanding WebObjects applications. 
Takes a close look at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Deveioper’s Guide 

by NeXT Software, Inc. 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OpenStep objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering OPENSTEP, Mac 

by NeXT Software, Inc. 

Introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the creation of three applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APIs, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further information, and services such as training and support. An 
appendix offers a concise discussion of object-oriented programming. 
(BOOSTEPM) Our Price $15 

Discovering OPENSTEP, Windows 

by NeXT Software, Inc. 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity, Along the way, 
it explains concepts and illustrates aspects of Objective-C, OpenStep 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) Our Price $16 



Object-Oriented 
Programming and Objective C 


by NeXT Software, Inc. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
Objective-C is easy to learn and use because it adds very little 
syntax to the C programming ianguage. It's dynamic nature aiiows 
you to accomplish things nol possible in most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ interface Builder (for eof) 

by NeXT Software, Inc. 

A hands-on, award-winning book designed to help you get your job 
done with the updated Interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1,1. For any programmer 
using interface Builder to design objects that truly work In 
NEXTSTEP. 

(BWIB) Our Price $24 

Using EOF 2.1 w/ OPENSTEP (Mac & Windows) 

by NeXT Software, Inc. 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP. It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework applicalion. 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mac & Windows) 

by NeXT Software, Inc. 

The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework toots and classes, it includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling, 
(BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 (BE0FDG20) Our Price $24 
EOF Developer's Guide for EOF 1 .X (BEOFDG1X) Our Price $24 
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Increasing Hits and 
Selling More on your 
Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and 
tricks you need to know to make your 
site a commercial success. 

(BIHSMWS) Our Price $22.45 



This book gives you all of the 
management tools you need for 
creating a strong Internet and Web 
presence, A blueprint for your strategic 
plan, this book guides you every step of 
the way in establishing your company's 


place on the Internet and World Wide Web. 


The Internet 
Strategic Plan 

by Martin A. Schulman and 
Rick Smith 


(BTISP) Our Price $22.45 


Measuring the Impact of 
Your Web Site 

by Robert W. Buchanan and 
Charles Lukaszewski 
This book features case studies tram 
many successful and some less 
successful corporate web site pioneers. 
You will leam techniques and 
commercially available tools for 
measuring site traffic and visitor behavior-and help you choose the 
right ones for the job. Written by leading corporate site consultants this 
book tells you how to develop a management strategy geared toward 
optimizing web site productivity. 

(BMIYWS) Our Price $26.95 
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The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer gr^hic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrable technical jargon. 

(BWCGW) Our Price $29.65 

Debugging Macintosh 
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Software 
with MacsBug 

by Konstantin Othmer and 
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||M «TlltAU!l 


Jim Straus 

MacsBug. tram Apple Computer, Inc., 
is the leading debugging software 
program for the Macintosh. This 
book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31.45 



Tho Wob Navigator 

by Paul Glister 

This book keeps you right on top of all 
the recent changes in the Web, tells 
you what’s out there right now and 
what's coming in the future. You'll get 
samples of various Internet sites and 
candid discussions of providers. You'll 
receive proven strategies for finding 
and managing information. 

(BTWN) Our Price $22.45 



Everything you need to master the 
fundamentals of JavaScript 
programming is In this bod</CD-ROM 
package. A special easy-to-use 
reference section offers detailed 
analysis and examples of objects, 
properties, event handlers, and 
statements. You'll also find all the latest information relevant to 
JavaScript programming since the advent of Navigator 2.0. 
(BJSCB) Our Price $44.99 


JavaScript 

Cookbook 

by Yosef Cohen 



HTML Sourcebook, 3rd 
Edition 

by Ian S. Graham 

Critics everywhere agree, HTML 
Sourcebook is the best guide to HTML 
for Web professionals. That's because 
no other book makes it so easy for you 
to quickly master all the commands, 
tools, and expert techniques you need 
to create cutting -edge Web page 
documents. Completely revised and expanded by nearly 50 percent, 
this new third edition of the best-selling guide to HTML gives you the 
complete lowdown on all the changes and enhancements to the 
HTML, HTTP, and URL standards. 

(BHTMLS) Our Price $26.95 
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Designing 3D Graphics 

by Josh White 


In this powerful book/CD- 
ROM package, top 
computer graphics artist 
Josh White tells you 
everything you need to 
know to create sophisticated real-time 
3D graphics for computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and hands-on modeling 
techniques that Josh White has learned while creating artwork for 
over 20 commercial games, including Descent, Zone Raiders, Locus, 
Legoland, and others. 

(BD3DG} Our Price $35.95 




Web 

Marketing 

VcooKgratm 



Web Marketing 
Cookbook 

by Janice M. King, Paul Knight, and 
James H. Mason 





Create the ultimate Web 
marketing site, quickly 
and painlessly! Learn how 
to build a Web site for so’ 
your small business or nonprofit 
organization with this step-by-step 
approach. This book/CD-ROM package contains your simple, non¬ 
technical tools for converting your print brochures, text, and graphics 
into a powerful online promotion. 

(BWMCB) Our Price $35.95 
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Developing CGI 
Applications with Perl 

by John Deep and Peter Holfelder 

A complete step-by-step guide to 
creating sophisticated interactive CGI 
applications using Perl. If you’re ready 
to build your own customized 
interactive documents, forms, graphics, 
and other full-feature CGI applications 
using Perl, then this book will show you 


how. Covers CGI. HTTP, and the Perl scripting language. 
(8DCGIA) Out Price $26.95 


Rhapsody Developer’s Guide 

by Jesse Feller 

Covers the basic architectural principles of Rhapsody: the Mach 
microkernel, object-oriented programming, and the elements of a 
modern OS such as preemptive multitasking, protected memory, and 
symmetric multiprocessing. Also shows ways of getting to this new 
environment—Objective C, conversion tools, and the integration of 
Java—to develop Rhapsody products. Paperback, 450 pages. 
(BRDG) Our Price $35.95 


: Check out our Web site! 

^ • Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Practicai Object- 
Oriented Development 
in C++ and Java 

by Cay S. Horstmann 

This book offers adwee on real-world 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design, C+-I-, and Java In a way that makes these potentially 
daunting operations more accessible than they've ever been before. 
(BPOOO) Our Price $31.50 



WebMaster in a Nutshell, Deluxe Edition 

by O'Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster's toolbox. The CD ROM contains the Web 
Developer's Libaray—^the full text of the latest editions 
of five popular O’Reilly titles: "HTML: The Definitive 
Guide, 2nd Edition"; "JavaScript: The Definitive Guide, 2nd Edition"; 
"CGI Programming on the World Wide Web"; "Programming Perl. 
2nd Edition"; and "WebMaster in a Nutshell." The Deluxe Edition 
also includes a printed copy of "WebMaster in a Nutshell," the all- 
inclusive quick reference that belongs next to every webmaster's 
terminal. Includes CO-ROM & 356 page book. 

Requirements: The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNUTD) Our Price $62.95 
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Programming For The 
Newton Using 
Macintosh, 2nd Edition 

by Julie McKeehan and Neil Rhodes 
This book gives you 
everything you need lo 
create Newton 2.0 
applications. From the 
people who developed the 
Newton programming training materials for Apple Computer, this 
book uses a clear and comprehensive approach to teach you how to 
program the Newton. Includes a CD-ROM full of sample code and 
additional goodies. The samples include solutions to all of the coding 
examples found in this book. Each example and exercise also has a 
narrated QuickTime movie showing the solution from start to finish 
in Newton Toolkit. 

(BPFNUM2) Our Price $31.45 
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Wireless For 
The Newton II 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK - the complete development 
environment tor the Newton 

(BWIRELESS) Our Price $31.45 
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JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect t)ook to show you how to 
turn Netscape into your 
own personal, 
customized operating 
system. Provides the 


inside tips and 
techniques for making your Web 

pages much more attractive. Shows you how to use all of the key 
features of the JavaScript language, including objects, methods, 
properties, events, and much more. Includes CD-ROM with 
numerous interactive scripts written in JavaScript you can add to 
your Web pages today. A complete set of the best Java applets. 
Useful plug-ins designed to supercharge Netscape and resources to 
help JavaScript programmers. 

(BJNWIZ) Our Price $31.45 





JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet 
Explorer 3.0. and LiveWire. Includes CD-ROM with Sun’s Java 
Developer's Kit. JavaScript and HTML Editors for Windows and 
Macintosh. 20 contributed ready-to-run JavaScripts and JavaScript 
examples from tiie book. 

(BJSDG) Our Price $44.99 




Web Graphics 
Tools and 
Techniques 

■ Ty V 


Web Graphics Tools 
and Techniques 

by Peter Kentie 

The ultimate source of information on 
Web graphics for both Macintosh and 
PC users. Recent technologies covered 
include; ActiveX. Sound, Adobe Acrobat. 
Java. VRML, QuickTime VR and video, 
Shockwave, and 3D Animation. 

(BWGTT) Our Price $35.95 




Guidelines for how 
tooplace information online 
within your company. 

Provides both a design and 
development process and 
a set of guidelines for the Internet, 
intranets, and help systems for designers and authors who need to 
create effective electionic information, includes CD-ROM with software 
containing files to help you utilize the models described in the book. 


Standards For Online 
Communication 

by JoAnn T. Kackos and 
Dawn M. Stevens 


(BSFOC) Our Price $40.45 


Linux Configuration 
& Installation, 

2nd Edition 

by Patrick Volkering, Kevin 
Relchard, and Eric R Johnson 

Linux, the leading UNIX 
variant, has garnered 
loads of attention within 
the UNIX community. The 
amazing Ihing about 

Linux is that you don't need a workstation to run it. Linux 
Configuration & Installation, Second Edition lets you run Linux today. 
Program with Linux using C, C++, Pert, and Tcl/Tk. The 2 CD ROM 
pack offers one of the most popular Linux distributions. Siackware 96, 
and comes directly from Patrick Volkering, the creator of Siackware. 
(BLCI2) Our Price $35.95 
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Web Publisher’s Design 
Guide for Macintosh, 
2nd Edition 

by Mary Jo Fahey 

This is the only book that takes you 
step-by-step through real projects 
designed by talented new media 
artists. Internet design experts share 
their design secrets and art liles (look 
for art files on the companion CD-ROM 
by artist's last name). This expanded new edition includes 
Photoshop, Illustrator and DeBabelizer tricks from the first edition 
plus countless new ways to liven up your Web pages with 3D 
graphics, sound, movies, and much more. 

(BWPDG2) Our Price $35.99 


Getting Hit&-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Geffing Hite explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promofion. Just a few of the topics 
you'll learn Include: using search 
engines with URL's; linding related Internet groups or lists; 
understanding tee nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts. With this book, 
you'll go beyond tee conceptual and actually follow real-world tested 
promotional campaign strategies, Bring the world to your Web site! 
(BGHITS) Our Price $17.95 
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BASIC for the Newton 

by John Schettino and Liz O’Hara 

Program on Macintosh. Windows-based PC, or on 
the Newton itself. Straight-forward “programming by 
example” approach - you’ll be writing Newton programs right away. 
Includes 3.5" disk containing Demonstration NS BASIC and over fifty 
example programs (Newton not included). 

(BNEWT) Our Price $32.35 

SEE RELATED CATEGORY; Dev. Environments 



HTML For The Worid 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You'll 
be up and tunning in no fime. If you 
need to learn HTML fast - this is book 
is for you. 

(BHTMLW2) Our Price $16.15 



Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 


The complete resource for creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
g create Shxkwave movies and put 

them on the Web. Expert tips from the 
creators of Macromedia's first 

Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 


Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from teeir development environment. Essential 
infomation for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool (or Macintosh programmers. 

(STBASST) Our Price $89.95 



OPTIMIZING 

CODE 



Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmarcik 

Take (uil advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35.96 
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JavaScript For The 
World Wide Web 

by Ted Gesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through tee 
software and show you what to do. 
Works tike a reference book, you look 
up what you need and teen get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know. 

(BJWWW) Our Price $16,15 
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Programming for the 
Newton Using 
Macintosh:Software 
Development with 
NewtonScript- Second 
Edition 

by Julie McKeehau & Neil Rhodes 





Praise for the Second Edition! "Rewritten from cover to cover, this 
new edition teaches you the essentials of programming for Newton 
2.0. You must read this book. Then read it again. And again .. 
SCRIBBLES (OxNUG, Australian Newton Users Group) Includes one 
CD-ROM for Macintosh 68030 or higher, 466 pp. 

(BPENUM) Our Price $31.45 




grnwfflinill! CanllieMacintosh 
Second Edition 

by Dave Mark 

New revised edition! Easy-to- 
understand ~ everything you 
need to start programming. Updated and 
enhanced exercises that lead you step by step. 
You'll learn function, variables, point datatypes, data structures, file 
input and output and more! Includes CD-ROM with Metrowerks 
CodeWarrior"^ Lite. 


(BLEARNC2) Our Price $33.25 

SEE RELATED CATEGORY; Dev. Environments 


OBJECTIVE-C 
Object-Oriented 
Programming Techniques 

by Lewis J. Pinson and Richard S. Wiener 

Presents the basic concepts of object-oriented 
design and programming, and provides a 
precise description of the Objective-C 
language. Several small-to-medium sized applications using 
Objective-C illustrate the general principles of object-oriented 
programming. Covers the two main versions of the Objective-C 
language. Demonstrates the versatility and power of the NeXT 
machine as a platform to support object-oriented programming. 

Shows how to design, implement, and use hierarchies ol classes. 
Explains the purpose of pre-defined classes and shows how they 
can be used in designing programs. 

(BOBJCOOPT) Our Price $34.15 

Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE User's Guide. This is the printed version of the 
documentation provided m the CD. Covers CodeWarrior Professional 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34.95 

SEE RELATED CATEGORY; Dev. Environment 
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Metrowerks CodeWarrior 
Programming 

by Dan Parks Sydow 



Includes CodeWarrior Lite, and Full Coverage of PowerPlant™. The 
best information on Metrowerks CodeWarrior, giving full coverage to 
the Gold Edition. CD includes Code Warrior Lite. 

(8CWPR0G) Our Price $35.95 


C++ Programming 
with CodeWarrior 

by Jan L Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C-i-i- as the example language and 
Metrowerks and CodeWarrior as Die example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 

(BCPPCW) Our Price $32.35 



CodeWarrior Software 
Developmentusing PowerPlant 

by Jan L. Harrington 



C-i-f programmers will learn to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code for all Die programming 
examples in Die book and Metrowerks CodeWarrior Lite. 
(BCWSWDEV) Our Price $31.45 



inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlanl classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
PNSPP) Our Price $34.95 
SEE RELATED CATEGORY; Dev. Environment 



AppleScript Finder Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY; Scripting 
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A complete reference for anyone using AppleScript to modify existing scripts or to 
write new ones. Contains useful information tor programmers who are working on 
scriptabie appiications or compiex scripts. Features detailed definitions of 
AppleScript terminology and syntax in the following categories: Value classes, 
commands, objects and references to objects, expressions, control statements, 
handlers, and script objects. Includes many sample scripts, discusses advanced 
topics such as writing command handlers for script applications, the scope of soript 
variables and properties declared at different levels in a script, and inheritance and 
delegation among script objects. 

(BALG) Our Price $26.95 
SEE RELATED CATEGORY: Scripting 


AppleScript Language Guide 

by /t^ple Computer, Inc. 


AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Scliettino Affiliation & Liz O’Hara 



Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
“Mac-Like". Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2.1, source code for all example 
appiications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price ^1.45 


Using 

CGI 


special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 



Second E4iwn qub 


This complete reference provides 
professional Web developers and advanced 
personal users with bie latest information 

on using CGI (Common Gateway Interface) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44.99 








Java in a Nutshell, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall functionality, A 
comprehensive tutorial on "inner classes" 
that explains how to use all of the new types 
of inner classes: static member classes, member classes, local 
classes, and anonymous classes, Practical, real-world example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, the new AWT event handling model, 
internationalization, and a sample Java Bean. 

(BJNUT2) Our Price $17.95 


JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take advantage 
of the power of Netscape Navigator. Expand 
the capabilities of your Web page, without 
having to understand C or C-i-i-. CD-ROM 
contains “Wiziets" that allows you to easily 
create your own JavaScripts. Takes you step- 
by-step through programming cross-platform JavaScripts. Details 
how to create JavaScripts for JavaScript-aware Web browsers. 
(BJAVASCRPTJ) Our Price $40.50 
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Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L Perkins 
with Timothy Webster 


J ava interactivity and multimedia to Web pages! 

“ A step-by-step guide to make your Website 

come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 


3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains die complete QuiclOraw 3D 
system itself and a complete database of the QuickDraw 30 API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

{B3DGRAP) Our Price $35.96 




IHcks of The 




Mac Game 


Programming Gurus 

by McComadf, Ragnemalm, Celestin, et al. 
For beginning to expert game programmers. 
Complete overview of all the necessary 
components ol game programming on the 
Macintosh. Packed with valuable tools, 
utilities, sample code. CodeWarrior’^“ Lite and game demos. 
QuickDraw 3D and Power Mac optimization and inside info on how 
Glyptra III was created. Hundreds of tried-and-true tricks, tips, and 
insider secrets from well-known Mac game programming experts. 
(BTRICKS) Our Price $45 


Black Art off Macintosh 
Game Programming 

by Kevin Tieskoetter .. 

Develop your own 30 games in 
C on the Mac. Includes (XI with (>0^ 
project Files for both Symantec 
C and Code Warrior. Create ' * ® 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code - all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35.99 



Check out our Web site! 

Full product descriptiuns • Hundreds of more products 

http://www.devdepot.com 




Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software’s color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference infomiation in both 
OuickView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 


(BADVCI) Our Price $33J25 





Pnitca Yoiir Privacy 
on the 

Internet 


Ihe Internet 
Marketing Plan 

by Kim M. Bayne 

This book gives you a comprehensive 
framework for producing and exe{;uting 
a customized Internet marketing plan. 
Marketing communications veteran Kim 
Bayne supplies you with a clear set of 
step-by-step procedures for 
establishing, implementing, evaluating, 
and managing your company’s online 
presence. 

(BUMP) Our Price $35.99 


Protect Your Privacy on 
the Internet 

by Bryan Pfaffenberger 

This book/CD-ROM package gives you 
proven privacy defense strategies and 
techniques to help you make the Net a 
safer place to work and play. You’ll get 
the names of Internet privacy 
organizations that are working to 
protect your privacy rights and find out 
what you can do to help. 

(BPYP) Our Price $26.99 


Order Toll-free 
800-MACDEV-1 
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INSIDE MACINTOSH 


1>y ;Kj;plcCoirjiputei» Inc l- 





Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More tban 25 volumes in electronic form. 
Includes: QuickDraw^'^ GX Library, Macintosh 
Human Interface Guidelines, Pow/erPC System 
Software, Macintosh Toolbox Essentials and More 
Macintosh Tooibox, QuickTime and QuickTime 
Components. Access over 16,000 pages of 
information with Hypertext iinking and extensive 
cross referencing. 

(BIMCD) OurPnce $89 



The"’®/ Limited time offer to buy these Inside Macintosh products - 10 % off! For full 

product descriptions please see our Web site, or feel free to call, tex, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Inside Macintosh; Devices 

BIMDEV 

26.95 

Inside Macintosh: Files 

BIMFIL 

26.95 

Inside Macintosh; Interapplication Communications 

BIMIAPP 

33.25 

Inside Macintosh: Memory 

BIMMEM 

22.45 

Inside Macintosh; More Macintosh Toolbox 

BIMMAC 

31.45 

Inside Macintosh: Networking 

BIMNET 

26.95 

Inside Macintosh; Overview 

BIMOVER 

22.45 

Inside Macintosh: PowerPC Numerics 

BIMPPCNUM 

26.05 

Inside Macintosh: PowerPC System Software 

BIMPPCSYS 

22.45 

Inside Macintosh: Processes 

BIMPROC 

20.65 

Inside Macintosh; QuickDraw GX Prog. Overview 

BIMGXOV 

22.45 

Inside Macintosh: QuickDraw GX Typography 

BlMGmP 

26.95 

Inside Macintosh; QuickTime 

BIMQT 

26.95 

Inside Macintosh; QuickTime Components 

BIMQTCOM 

31.45 

Inside Macintosh: Sound 

BIMSOUND 

26.95 

Inside Macintosh: X-Reference 

BIMXREF 

17.95 


(Book sale prices are contingent upon availability) 
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hot 

Programmers & Dev^ioper% 

MdcTM 

MAGAZINE 

MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date vwth everyttiing they neet 
know about software development. Topics like Rhapsody, Java. QuickTime. OPENSTEI 
Objective-C, C/C++. Object Oriented Technologies, product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 
(MTYRCM) Canadian for 12 issues $59 
(MTYRFM) International for 12 issues $97 
Back Issues: each plus shipping (subject to availability) $10 

MacTech® CD-ROM Volumes 1-12 

• Includes Apple’s issues 1 -29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved indices, and a new THINK Reference Viewer- 
fw lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of TXINK Reference™—the original online guide to Inside Macintosh, Vote. 1-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of Frameworks archives known 

• Sprockets'll MacTech's tiny framework that compiles quickly and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 





PRODUCT 

Development Environments 

CODE 

PRICE 

PRODUCT 

CODE 

PRICE 

^iiillcaiicns: Oufltirig Applfcattons .. 

.BAPSCAP . 

.4531.45 

Maontosh C Htwraniniing Primcf Woaitc I ... 


, ...24.25 

Basic 11 % Ninvtqfi MrograniiTH^ tisng NS __ .. 

.BMrwT... 

.. 3Z.3S 

MacinlnKh C Prn^rarrtniing Prirruif Wohimfl 1.^. 

.. .BCPtwe, __ 

44 .,,.... 24J25 

C++ Prajjrammitig ,, 4 *, 

__Udl^MACAP,,,,. 

,.4*...*.... .31.45 

Mariintreh Pj^snal Piugrammlrig FViniBr Vblurnfl 1.,... 

RPAACPBf 

..24.25 

Plfigi Furimin^ wtlh DnrlrAVarrinF.. ,,.,_ 

BCPPCW,... 

..32.35 

MastBorio tlie ThuiKCtos Ubfary.... 

,...44 ...4 ..BMAStTFTCL 

„ 26.95 

C/C++ SDK usena Gu«e... .... 


.29.0© 

MastBrtnQ me Toetja* usir^j Thak C ........ 


24.25 

QxJdW/l^niof Inside PowHPten...... 


..34.95 

Mebtufirb; rjikAWtin iiw Pirn^nmiTiiri^.... . 

.. 

.pcilVPncKF .. 


CwleW^int SiHwati Devdkpiwil iisino Pwweft* 1 »H.- . 

fyiMrlng tVn^mnwB Kit 

_eOAISSNDFV .. 

31.45 

Collectives' - UEMectHunentied Rragtaniming___ 

.(KIQJOOOPT. 

,, 

...34.15 

BnvBCRD£ 1 G__ 

34.95 

fVntantinn Uajjic ........ .. 

. 


titan tlio pi cpx . 

nrukfwi 

laiK 

Miilrl Apfilii'..... 

.BREMMD. 

3Sa5 

bisrif! (IflrkAKftiriwr flmnfe 

RWSflW 


SyinarlecC++ ProQiBinniiig 

nSYUCFP 

.39.50 

Nlartf COREA...... ... 

... . .am ™ .. 

_ 

..„.ir.99 

ieii|%itris G(i 1 £% IQ ... . . 

...ETMJGENT. 

17.55 

1 H^nft PmgrHirmfifift i+fHinn.,,.. 

...... 

....74,95 

Tlie PoMcr ol Pid^nipli CPX . . ... 


.19.05 

1 ftam CrUt Ihn Uaj’nlnfJi, 2 nrl TrSliiin . . 

HLtAfffO. 

. 33LZ5 

tteaBlI Prngr 7 irninlfi[} wtfh Pmgptpli ..... 

... 

.30.B0 

(jam Oi t Of) Ilia MadntosJi.......... 

.Rl RNOPP.......... 

..3s.es 

Wretess hif 1i%Nw4oii .. . *.... 

..4,aWlRElJ^... 

..,31.45 

Web site; http;//www.devdepot. 

com • 

E-mail: orders@devdepot. 

com 
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Hardware 


AppL? m nnM 


.nmwAwn 

14.36 

De^niiig nfurii; 4 ntiwtrs fur iti; Miuxitisli . 


BCA8U.. 

26.96 

LaSOrVIWtor Itoforenite. 



17,96 

ArtliiHrtiinr 3rd .. .,, . 


.._ 

.Etf>rz^.... 

31.46 

PiwwT’^^ S]r^ Ad^utedixe.. .... 


.ittWVtjUM 

31,46 


hstde.........RAPTAl K ....,...31.45 

hskkrliTeMacin*!^ Communicatlors loolDQ?i.,„.......—...22.45 

lasRfWirtwfiidHffifK^ft . ....... BUStHRtr 17.96 

Learn C++ on fie MaoifMnsJi.......aJM3>P_35.05 

Lem C 0(1 fie Macfftosfi. 1st WftJon...... __.31.45 


I em^ C UR fie 2iid BiSBot 

Mac Progranifnlf^ Ax Qu!m»s.. 


Inlemet Related 


MacnlQ^ C PnXf^iirrierl’iliiier^^ 1.. 


,BUAHNC 2 ...„.,.. 

.attOJUM. 

nCPRWi 


17.9S 

24.25 


1994 kittntel White Pacjt-] ..... 

.BSiWMit , 

,. .26.95 

1 # rru^aiiiiiid riHiii;i e ... 

hfevwindi ni r> Pim WfcvkM¥i iiwlh rtomi; 

B0LE2 

40.45 

Active Jhwa..... 

_BACTJAVA 

nm 

■ 1 Wn>M mP^I Un.L.r FniAfi flCWFillS^jia ¥¥vpi Vnlll vl^tAalS' aaaaaj ■ 1 .... 

ftftVhrailtoktoilrt ftkrfmAp Uryhiffvi B 



Ain^ CNtos lor ()utnpie&.. —. ... 

..BAQUUM - 

.17.95 

Pw^Vyaif iwcai iTv 9 r»Tinino tTinw TOwmB i.—--. — 

Mu^ifcpu'Ji Px'PLnrmfTFVvwi Cuunrnic ^iwHI ariilinn 

... IVinQl+Ttl . 

HPWTIFT 

. 

2 fl 76 

Ca Bf fjiamiifa__ , .. ......... 

BOGiat 

31.45 

MoLVltUSn t^OypvBilTMiy oBD^S ou ewm. .III II 

U^rinkTd^ Pf r^Airiritur^ T|i 


31 Sfi 

OiiUingAMairttetejngarinimh^ . 

_BBAMAI. 

46.00 

Uk-fncfitt HAoisI ■ ■: I 1 1 C^ iirgivwA 

nuir 

Ifi K 

Claris Hoiite Haw Compaw ..-.. 

.JQPC 

26.95 

mOuSDII. VlSUai ftH—r 1.1 ?lilJ rDiaAK^.4a.Ly. -- 

UiVj4 tils^ aiwaiiiiw UMi 

OMmiFIFTlM 


Coiiiwtei Privucy t^JSldt)^. ..... 

__BPHV ... 

„ 22.45 

UAl^urtrir f 


ITT- ■ j - 

hhhhh .. 59.95 

E-Mall ^ssmm .... 

.JEMAI£.... , 

22.45 

V^^Tn,Jlfi iTl^llllllu -niiiiilitiiili>ifci>< 8 e§niim<<<mii ..aihhJ' 111111 11 

„....43r*CTnj .-.»,„ 4 —.„,,, 

auCuufCM^ iri 

Ai\ dR 

blgmsfUs at t-Mail 8 tyte. ... . . 

.BfMAl... 

13.45 

Hflwton Progranwung GiadB.,.. ,, .. 

. .omtlFi! t ruUlU n.... 

nnrtppeript: 

_ W-TO 

20 .G 6 

1 (qgied on J*mi......... 

.BHJAVA-. 

...26.95 

URfBtl •jnprilSO 4 HVfiWTIHig l,PB51yri . 

^nkiiiinsnn l^hmiijFirdir^ 

j4/lF34n¥^ 

% OR 

Inslail telamel Guide........... 

.BWSTANT... 

.13.45 

UpLlfllSlflf] rOWt^rU L4IW. . ... ...lUi.., —<»+l wi <4 mi P>P>+f« 44 m 44 aaa 44 HqM 

Rmi rhiiH^ rhiaffiitonra 

lrlTHa.....n. 

RPPRI RFF 

,„4+ 17.99 

lillsrrtel booK......... 

.BOHNn 

2250 


.prCTUju;r^^,,^Mnpp,H 

I^DCl A4MlCr 


tetwiwi to Dummlw 2 rto: Eifttlw.. 

^.aNrratiM?. 

17.99 

PmiMfyv^' ninlky Ujviud'« flidfia 

npnrruR 

^ AA 

tetoritH to DiiiTiiiksiQiiKkFteto^^.. ...... .. .. 

.auUMOCK. . .. 

.8.0S 


a.nPPP.DrUlLXW.- 

Ai\ RA 

tetenei to Macs to Dummies -. . 

.BAIETDUM 

„..(7.9S 

PiiMK PC PrtnjmiiHflis's Toofcil..... . 

fitengiF?!i 11 Mlilftoir IfSii 1 ifL ui’Im txi ttm U^i^mvIpw^ E^^Mi^lu 

.-iWl'l .... 

fiTAULV 

- 4U.3II 

M dR 

■nlnnet to Macs to Dunvntss BaatseHer LJtJOfi...... 

... .nnwuBf. 

.35.9B 

iTOgrHfTiuifig intiooijMiin \q rih wkhimrii rswiiijar.... ... 

Hf^rammtng to System 7....... .. 

,. ., .OrRIilLT 11 ...1 

..DSVS7.,.....,.. 

UtlMLJUlU^ 

.. ■«,'W 

.24.25 

to lil 

tetotid Penns Tiulb..... 

.w-wnroa. 

.36.00 

Intoito Pitolstiino —..... 

.BPWAA 

.36.00 

Pmyrunvruig diREJ Macmosli Volumo 1 .... 

PnvininMibvi Idl 

RPRnfTTART 

40.50 

intoTteL llte. Mute bd»oii........ 

.RNFmnjjit . 

31,50 

l‘Art 44 PUPnmifvi uirflh Armlbl-alb 

BPROAT 

2? 45 

Itoaito¥to 9 ttow EntopilseAltoiteliv^ . . 

. Bil4TWO. 

44.99 

OiMTiii 0 rWikiiV to tavinto-ti Htw* 

-BOIGLIDE 4 4—H 

4^.00 

TKeiM to rXf+Prugrmiws..^^. 

.BJttWtSSWl,..,.. 

-....17.95 

UWfAIBIlip %ts TWliMKIivVi AMBSann^.n. ■■.■■■. in ran i • an ni ■ rni pi 

ttoy VUvIH AiwAi 

KW-JUlM LI 


Java in a Muishel_ . .__ _ 

... BJAVAWT 

1345 

Ajf Ikfcntgrfl ^iiw 

ewccTitw 


JevaliTiBoawAHtSupei^ .... . 

.BJLAa.. 

.53.99 

QncF'Hit n^vnntM^ jBfvl ^ hin m 

...—... 

RiTjarw 

,r, ££ 4+0 

tTI A 

.hni RijyramnMit) witlt CORELA . 

.BJINC. 

J».99 

ApcTfUl DhtfjTHfni 



JavsGCftot to Macxitoh.. . —__ 

......bjavascrpi 

4050 

TWS^ nil n?|3tMIV:i2 w-.+w,-iaai-i-„-i.ni,iTa„r... 

^^AftuMtoi Bfu r^Ks^^fe'L' rSuAlSr^ IlHto FiiCni'llu Qnllivttiii 

RinF!3rtN 


Loam H1 ML on tee Mactetosn.. ....... 

d I1TM1 . 

26.95 

uBIIfnlFtE Uy Ln*Syii. Ucotl ^ iCmS 4 F£ll,p^ aHUIVKIfli - t 11 .. ., i ai. —=: 

i'* + i toir t'hua liA^^ntoieK TTvi D ■■Lmup 

nvaruTih 

.-£IMP 

m jc 

1 cam Java on mo Mactitoai.. .. ... 

..BLIAMA... 

.31.45 

^yb~y ■TrnOt hJt^wnnti'wrto ja. j. feA '^1 llAaitei 


+J-9h'W 

won 

Masteiirq MrfstutoJ 2.0 to MaciiiuEii. Sgcniil Fdrttoi.... 

.BMASI*E2........ 

..36.00 

loaui iwx 5 t 3 T Mfiuiufcn (.#++ a £i uervs...„tt_... ... 

Tcv4wihf*fil ittllriJiflt aHalVt llL 41 tel FjkniRlU 

ffirnui- 

24.26 

Mote Intotwl to Dummies ^to 1£1L. ......___ 

.flOUMttT,... 

1795 

TrlRIiAll Ra4llJtl HJ 11 iLr nFnAaHiDLMlI FlB 1 liljr i... s.. ... 

inti fin ^snlHunins tVKiiin 

print; 

2095 

lATTJdr to iViiiffliM _ _ 

......BMOTiOliM 

17.99 

Wtratoss to the Mewten Devetapmari to Motif Comm,..,--,,-... 

UUpfHlVI J 7tf''^rlil'4ltll4- ^lIllKlFn 

.OWIBELES....,. 

ui OTyu 

.31.45 

HelfSat. . ___ ___ 

.BNticmi ... 

.17,00 

14aiUl:iE]CisFuatoi l-teiiilltoik ..-..... 

BNETOFM... 

45.00 

rrriLllRj 1 TtMlVolllij -WiffdfU ..... MM.IIiai'fn.- 



Naiscape Naviwtor 3.0....... 

. mnm .. „ 

,-26.96 

Miscellaneous 
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BINETMSK 

,-.,..31.49 
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1799 
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.31.46 
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BFRAG.—-*4-4,44-4 

..3&,96 

f 4 lu iwaigyiliy TtfaLnllDa . ... 

_riPT.Ili^WtCii .r,,|a,a.. 
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...31,46 
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ni+ilKti 14VI tha mn*i 


31.46 
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All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 
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Have you seen this man ? 

Hacker Harry and the pirate gang are 
loose and robbing the software stagecoach. 
Whether it's software, bank account information, 
money transactions, or customer databases, 
if you want to stop them and collect your 
part of the reward... the place to find your 
New Generation Protection solution is at: 


micromacro.com 


The expected losses due to piracy in the software industry alone 
are over $15 billion for 1997. Some of this belongs to YOU. 
By using MicroGuard’s New Generation Copy Protection keys, 
you will enforce your rights and guarantee your profits. 





USA 

MicroGuard 

631 South Pontiac St. 

Denver. CO 80224 
USA 

Tel: (303)320-1628 
FiLx: (303) 520-1599 
E mail: us3@micromacm.com 


VjNtlOWS.. 

CCWPATtRLE 


Miap Macro Technologies, Ucl. 
3 Ha^shikma St. 

P.O.Bok 11516, AzurSSDOl 
hvdd 

Id: (972-3) 558-2345 
Fax: (972-3) 558 2544 
E-mail: i fTfo@mi cromacro-coni 
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f.Wh.eii Rhapsody gets here. 


, .ti ! y*" ready.,.wli 


;f'r- 


odeWarrior I,atltude!*^ 






^ Matpowarks' newast 

I Z porting tool, designed to 

p « 

? fj give you a leg up on 

f Rhapsody. Reaorapile your 
.. JIaa OS source code, link It 
the I,atltude libraries 
and find out which portions. 

' of your code are going to 

K ,:y.-1S£ --- ■ ^ - - 

port smoothly...and which 

r won’t [forewarned is fore¬ 
st armedl. As Rhapsody evolves, 
;/ SO will Latitude; registered 
users will receive all 
developer releases, the 

"T". .1 ■’ 

^ first full release, plus 

’p' 

P ^jfe7 °*'®* additional update. 

L_ jOodeWarrlor Latitude. $599. 
'The tools you need. ..and 
little attitude to boot. 


metrowerks i 


httpj//www.metrowark3.a< 


























